checkpoint-brief

Name: checkpoint-brief
Author: WILLOSCAR

489stars39forks

How to install checkpoint-brief?

willoscar/research-units-pipeline-skills/checkpoint-brief

$npx -y skills add WILLOSCAR/research-units-pipeline-skills --skill checkpoint-brief

Installs into the current project.

Summary

Project completed stage Artifacts into a concise human-review block in DECISIONS.md; use before a Workflow checkpoint, not for Workflow routing or approval.

Files · 1

View on GitHub

SKILL.md

1	# Checkpoint Brief
2
3	Prepare the review surface between machine-produced Artifacts and a human
4	checkpoint. This Skill summarizes; it does not choose a Workflow, approve a
5	checkpoint, or modify semantic Artifacts.
6
7	## Inputs
8
9	- the active `PIPELINE.lock.md`
10	- the stage Artifacts named by the current Unit
11	- the existing `DECISIONS.md`
12
13	## Output
14
15	- one current checkpoint block in `DECISIONS.md`
16
17	## Steps
18
19	1. Read the locked Workflow and current checkpoint.
20	2. Inspect only the declared stage Artifacts.
21	3. Summarize scope, structure, coverage, and unresolved choices without adding
22	new research claims.
23	4. Upsert the checkpoint block while preserving the approval checklist and
24	prior Decision history.
25	5. Stop before approval. `human-checkpoint` owns the approval Decision.
26
27	## Acceptance
28
29	- `DECISIONS.md` names the current checkpoint and the Artifacts reviewed.
30	- unresolved choices are explicit and bounded.
31	- no approval is inferred or written.
32	- no Pipeline lock, Unit state, or semantic Artifact is changed.
33
34	## Script
35
36	```bash
37	uv run python .codex/skills/checkpoint-brief/scripts/run.py \
38	--workspace workspaces/<name> \
39	--checkpoint C2 \
40	--inputs 'outline/taxonomy.yml;outline/outline.yml'
41	```
42
43	The Pipeline adapter supplies the current Unit's declared `inputs`. Manual
44	invocations must do the same; an empty input list is reported as unreviewable
45	rather than inferred from unrelated Workspace files.

People who liked this also viewed

6 picks

Type

checkpoint-brief

489stars39forks

View on GitHub

How to install checkpoint-brief?

willoscar/research-units-pipeline-skills/checkpoint-brief

$npx -y skills add WILLOSCAR/research-units-pipeline-skills --skill checkpoint-brief

Installs into the current project.

Summary

Project completed stage Artifacts into a concise human-review block in DECISIONS.md; use before a Workflow checkpoint, not for Workflow routing or approval.

Files · 1

View on GitHub

SKILL.md

1	# Checkpoint Brief
2
3	Prepare the review surface between machine-produced Artifacts and a human
4	checkpoint. This Skill summarizes; it does not choose a Workflow, approve a
5	checkpoint, or modify semantic Artifacts.
6
7	## Inputs
8
9	- the active `PIPELINE.lock.md`
10	- the stage Artifacts named by the current Unit
11	- the existing `DECISIONS.md`
12
13	## Output
14
15	- one current checkpoint block in `DECISIONS.md`
16
17	## Steps
18
19	1. Read the locked Workflow and current checkpoint.
20	2. Inspect only the declared stage Artifacts.
21	3. Summarize scope, structure, coverage, and unresolved choices without adding
22	new research claims.
23	4. Upsert the checkpoint block while preserving the approval checklist and
24	prior Decision history.
25	5. Stop before approval. `human-checkpoint` owns the approval Decision.
26
27	## Acceptance
28
29	- `DECISIONS.md` names the current checkpoint and the Artifacts reviewed.
30	- unresolved choices are explicit and bounded.
31	- no approval is inferred or written.
32	- no Pipeline lock, Unit state, or semantic Artifact is changed.
33
34	## Script
35
36	```bash
37	uv run python .codex/skills/checkpoint-brief/scripts/run.py \
38	--workspace workspaces/<name> \
39	--checkpoint C2 \
40	--inputs 'outline/taxonomy.yml;outline/outline.yml'
41	```
42
43	The Pipeline adapter supplies the current Unit's declared `inputs`. Manual
44	invocations must do the same; an empty input list is reported as unreviewable
45	rather than inferred from unrelated Workspace files.

People who liked this also viewed

6 picks

Type