RomanNum3ral
/
gstack
mirror of https://github.com/garrytan/gstack.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

feat(plan-rollout): compress SKILL.md.tmpl further (204 → 179 lines) 

Apply Anthropic skill-authoring guidance from their public docs:
"every line is a recurring token cost; if a competent reader wouldn't
miss it, remove it." State what to do, drop the why/narration. Trust
that the reader is Claude.

Cuts:
- "What this skill does/doesn't do" prose framing (replaced by terse
  bullets)
- Per-step rationale paragraphs ("These edges are how you order slices
  because...") → kept the rule, dropped the explanation
- Repeated "no slicing" hedging across multiple sections → one source
  of truth in the When-to-invoke section

Behavior unchanged. Generated SKILL.md drops 1011 → 897 lines (~10%
fewer tokens at every skill invocation).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Manas Srivastava 2026-05-11 11:39:59 +05:30
parent 6132e7f5ab
commit 245dd786e7
2 changed files with 148 additions and 198 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

173
plan-rollout/SKILL.md
View File

@ -4,10 +4,10 @@ preamble-tier: 3
interactive: true interactive: true
version: 0.1.0 version: 0.1.0
description: | description: |
Decomposition-as-artifact. Given a real working diff (and `SYSTEM.md` if Decomposition-as-artifact. Reads a working diff (and `SYSTEM.md` if
present), produces a `decomposition.md` with per-slice file lists, present), writes `decomposition.md` with per-slice file lists,
reader-time estimates, dependency edges, and contract-graph reconciliation reader-time estimates, dependency edges, and reconciliation flags.
flags. Runs after a diff exists. Use when asked to "decompose the diff", Runs after a diff exists. Use when asked to "decompose the diff",
"write a decomposition.md", or "plan-rollout". (gstack) "write a decomposition.md", or "plan-rollout". (gstack)
Voice triggers (speech-to-text aliases): "decompose the diff", "write a decomposition", "plan-rollout". Voice triggers (speech-to-text aliases): "decompose the diff", "write a decomposition", "plan-rollout".
allowed-tools: allowed-tools:
@ -745,38 +745,31 @@ In plan mode before ExitPlanMode: if the plan file lacks `## GSTACK REVIEW REPOR
PLAN MODE EXCEPTION — always allowed (it's the plan file). PLAN MODE EXCEPTION — always allowed (it's the plan file).
# /plan-rollout: Decomposition-as-Artifact # /plan-rollout
You read a working diff (plus `SYSTEM.md` if present) and write Write `decomposition.md` describing how a real diff should ship as a
`decomposition.md`. You never write code, never split branches, never PR stack. Never code, never split branches, never run `/ship`.
run `/ship`. The output is the artifact and only the artifact.
## When to invoke **Don't run** on diffs that are ≤1 component + ≤30 min reader time +
no hard edges — output one line ("This is one PR. No decomposition
needed.") and stop. False slicing is worse than no slicing.
Run when a diff already exists (committed or working tree). Don't run on **Don't run** before code exists. Tell the user to write a real diff
single-component, sub-30-min-reader-time diffs — produce the one-line first.
"this is one PR" verdict and stop. False slicing is worse than no slicing.
If invoked before any code has been written, stop and say so: nothing Out of v1: `rollout.md`, spill-check, `/ship`/`/review` integration,
to decompose, re-run against a real diff. SYSTEM.md scaffolder.
Out of v1: `rollout.md`, spill-check, `/ship` and `/review` integration, ## Step 0 — Detect
SYSTEM.md scaffolding.
## Step 0 — Detect repo state 1. Repo root: `git rev-parse --show-toplevel`.
2. Base: `gh pr view --json baseRefName -q .baseRefName`, then
`origin/main`, then `origin/master`. AskUserQuestion if unresolved.
3. Head: `git rev-parse --abbrev-ref HEAD`.
4. Plan source: arg path → `~/.gstack/projects/<slug>/...-design-*.md`
→ AskUserQuestion (paste / path / diff-only).
1. **Repo root:** `git rev-parse --show-toplevel`. Ask via Echo each value in one line. Facts only.
AskUserQuestion if not in a git repo; stop if unavailable.
2. **Base branch:** try `gh pr view --json baseRefName -q .baseRefName`,
then `origin/main`, then `origin/master`. Ask if unresolved.
3. **Head ref:** `git rev-parse --abbrev-ref HEAD`. If detached or on
the base, ask whether to use a description-only input.
4. **Plan source:** in order, (a) plan-file path from args; (b)
`~/.gstack/projects/<slug>/...-design-*.md` for this branch
(mirror `plan-eng-review`'s lookup); (c) AskUserQuestion for
paste / path / diff-only.
State each detected value back in one line. Facts, not prose.
## Step 1 — Read SYSTEM.md if present ## Step 1 — Read SYSTEM.md if present
@ -784,33 +777,28 @@ State each detected value back in one line. Facts, not prose.
test -f SYSTEM.md && cat SYSTEM.md || echo "(no SYSTEM.md — using path heuristics)" test -f SYSTEM.md && cat SYSTEM.md || echo "(no SYSTEM.md — using path heuristics)"
``` ```
If present: parse YAML frontmatter, build a path→component map If present: parse YAML, build path→component map (longest-path-wins),
(longest-path-wins), build the contract graph (`rollout-edge: hard` build contract graph (`rollout-edge: hard` edges drive coordinated-
edges drive coordinated-deploy warnings). deploy warnings later).
If absent: fall back to one slice per top-level directory touched. If absent: one component = one top-level directory of change.
Never invent a SYSTEM.md from heuristics.
## Step 2 — Enumerate the diff ## Step 2 — Enumerate the diff
Capture committed + staged + unstaged + untracked work:
```bash ```bash
# Tracked changes vs base. NO triple-dot — `git diff <base>` compares git diff --name-status "<base>" # tracked: committed + staged + unstaged
# the working tree to <base> and includes everything not yet pushed.
git diff --name-status "<base>"
git diff --numstat "<base>" git diff --numstat "<base>"
git ls-files --others --exclude-standard # untracked, treat as fully added git ls-files --others --exclude-standard # untracked, treat as fully added
``` ```
Union and deduplicate by path. If empty, print "No changes between Use `git diff <base>` (no triple-dot) so working-tree changes count.
<base> and the current working state. Nothing to decompose." and stop. Union, dedupe by path. Empty → "Nothing to decompose" + stop.
For >200 files, warn and ask before proceeding. >200 files → warn + ask before proceeding.
Bucket each file: with SYSTEM.md, via the path map (unmatched → `(unmapped)` Bucket each file: with SYSTEM.md, via the path map (unmatched →
bucket, flagged in output). Without, by top-level directory. `(unmapped)`, flagged). Without, by top-level directory.
## Step 3 — Light-touch import discovery ## Step 3 — Light import discovery
```bash ```bash
grep -E "^import .* from |^const .* = require\(" <file> # TS/JS grep -E "^import .* from |^const .* = require\(" <file> # TS/JS
@ -818,66 +806,58 @@ grep -E "^(from |import )" <file> # Python
grep -E "^import " <file> # Go grep -E "^import " <file> # Go
``` ```
Resolve each import to a component (or top-level dir). Record directed Resolve each import to a component. Record directed edges. External
edges `<file's component> → <imported component>`. Unresolvable imports or ambiguous imports: log + skip.
(external packages, ambiguous paths) are no-ops — log, don't fail.
## Step 4 — Propose the slice stack ## Step 4 — Propose the stack
Rules in priority order: Priority order:
1. **`rollout-edge: hard`** (SYSTEM.md): if BOTH sides of a hard contract 1. `rollout-edge: hard` (SYSTEM.md): both-sides-changed → one slice
have changed files, those files merge into one slice tagged tagged "coordinated deploy required — \<breaks-if reason\>".
"coordinated deploy required — <breaks-if reason>". 2. Topological by import edges. Cycles flagged + merged.
2. **Topological by import edges:** a slice ships after every slice it 3. `rollout-order` (lower first) breaks ties.
imports from. Cycles flagged + merged. 4. `leaf-util` / `types-only` float to slice 0.
3. **`rollout-order`** breaks ties (lower first). 5. Alphabetical for remaining ties.
4. **`leaf-util` / `types-only`** float to slice 0.
5. **Alphabetical** on remaining ties. Predictable > clever.
Per slice, compute: file list, lines +/-, dependencies, reader-time Per slice: files, lines +/-, dependencies, reader-time
(`ceil(lines/80) + ceil(files/5)` min; cap each slice at 30 min — split (`ceil(lines/80) + ceil(files/5)` min; cap 30 min — split or flag),
or flag if exceeded), reader guide (2-4 sentences, tired-reviewer voice). reader guide (2-4 sentences, tired-reviewer voice).
**One-PR escape:** if the diff is ≤1 component, ≤30 min reader time, **One-PR escape:** ≤1 component + ≤30 min + no hard edges → one-line
no hard edges, write a one-line decomposition.md ("This is one PR. No decomposition.md + exit.
decomposition needed.") and exit.
## Step 5 — Reconciliation flags (informational) ## Step 5 — Reconciliation flags (informational, never blocking)
With SYSTEM.md present, compute and print (never blocking):
With SYSTEM.md present, print:
- `import-without-contract`: A imports B but no contract declared. - `import-without-contract`: A imports B but no contract declared.
- `contract-without-imports`: contract declared with no supporting - `contract-without-imports`: contract declared, no supporting import
import edge AND no `note: runtime-only`. edge, no `note: runtime-only`.
- `rollout-order-inversion`: declared order disagrees with discovered. - `rollout-order-inversion`: declared order ≠ discovered order.
## Step 6 — Artifact location ## Step 6 — Artifact location
AskUserQuestion: AskUserQuestion:
- In-repo: `.gstack/plan-rollout/<branch-slug>-decomposition.md`
- User scope: `~/.gstack/projects/<repo-slug>/<branch-slug>-decomposition.md`
| Option | Path | Recommend in-repo when other `.gstack/` planning artifacts already
|--------|------| exist on the branch; user scope otherwise.
| In-repo | `.gstack/plan-rollout/<branch-slug>-decomposition.md` |
| User scope | `~/.gstack/projects/<repo-slug>/<branch-slug>-decomposition.md` |
Recommend in-repo when other `.gstack/` planning artifacts exist on the
branch; user scope otherwise.
## Step 7 — Write decomposition.md ## Step 7 — Write decomposition.md
```markdown ```markdown
# Decomposition: <branch-name> # Decomposition: <branch>
**Base:** <base> **Head:** <head> **Diff:** <N files, +A / -D> **Base:** <base> **Head:** <head> **Diff:** <N files, +A / -D>
**SYSTEM.md:** <present | absent — heuristics used> **SYSTEM.md:** <present | absent — heuristics used>
**Generated:** <ISO timestamp> **By:** /plan-rollout vX.Y.Z **Generated:** <ISO> **By:** /plan-rollout vX.Y.Z
## Verdict ## Verdict
<One paragraph. "This is one PR — no decomposition needed." | "Ship as <One paragraph. "This is one PR — no decomposition needed." | "Ship
N PRs in this order. Total reviewer time: ~M min." | "Stop. <issue>. Do as N PRs in this order. Total reviewer time: ~M min." | "Stop.
<X> first."> <issue>. Do <X> first.">
## Slices ## Slices
@ -887,35 +867,30 @@ N PRs in this order. Total reviewer time: ~M min." | "Stop. <issue>. Do
**Coordinated deploy:** <only if hard-edge applies> **Coordinated deploy:** <only if hard-edge applies>
**Reader guide.** <2-4 sentences> **Reader guide.** <2-4 sentences>
### Slice 2: ...
## Reconciliation flags (informational) ## Reconciliation flags (informational)
- ... - ...
(Emit only if SYSTEM.md present and ≥1 flag fired.) (Emit only if SYSTEM.md present and ≥1 flag fired.)
## What's NOT in this decomposition ## What's NOT in this decomposition
<Excluded on purpose. "All changed files allocated." if none.> <Excluded files. "All changed files allocated." if none.>
``` ```
Write the file, print its path, stop. Do not implement, do not split Write the file, print its path, stop.
the branch, do not run `/ship`.
## Self-check before exit ## Self-check before exit
1. Every changed file in exactly one slice (or flagged `(unmapped)`). 1. Every file → exactly one slice (or `(unmapped)` flagged).
2. No slice depends on a later slice (no cycles). 2. No slice depends on a later slice.
3. Verdict matches the math — if reader time is 4 min on 2 files, the 3. Verdict matches the math. 4 min on 2 files = one PR, not a stack.
verdict is "one PR," not a stack.
4. With SYSTEM.md, every slice maps to a real component name. 4. With SYSTEM.md, every slice maps to a real component name.
If a check fails and you can't fix the decomposition, write the file If a check fails and you can't fix it, write the file with the
with the failure flagged in the verdict. failure flagged in the verdict.
## Limits ## Limits
- Does NOT enforce or split branches — produces a doc. - Produces a doc — never enforces, never splits branches.
- Does NOT validate `breaks-if` claims — human judgment. - Does not validate `breaks-if` claims (human judgment).
- Does NOT scaffold SYSTEM.md (deferred to v2). - Reader-time is heuristic; v1 has no calibration data.
- Reader-time estimates are heuristic; v1 has no calibration data. - Mostly-one-component diffs with stray files: one PR with a "stray
- Mostly-one-component diffs with stray files: call them one PR with a files" flag, not a forced 2-slice stack.
"stray files" flag. Don't force a 2-slice stack.

173
plan-rollout/SKILL.md.tmpl
View File

@ -4,10 +4,10 @@ preamble-tier: 3
interactive: true interactive: true
version: 0.1.0 version: 0.1.0
description: | description: |
Decomposition-as-artifact. Given a real working diff (and `SYSTEM.md` if Decomposition-as-artifact. Reads a working diff (and `SYSTEM.md` if
present), produces a `decomposition.md` with per-slice file lists, present), writes `decomposition.md` with per-slice file lists,
reader-time estimates, dependency edges, and contract-graph reconciliation reader-time estimates, dependency edges, and reconciliation flags.
flags. Runs after a diff exists. Use when asked to "decompose the diff", Runs after a diff exists. Use when asked to "decompose the diff",
"write a decomposition.md", or "plan-rollout". (gstack) "write a decomposition.md", or "plan-rollout". (gstack)
voice-triggers: voice-triggers:
- "decompose the diff" - "decompose the diff"
@ -28,38 +28,31 @@ triggers:
{{PREAMBLE}} {{PREAMBLE}}
# /plan-rollout: Decomposition-as-Artifact # /plan-rollout
You read a working diff (plus `SYSTEM.md` if present) and write Write `decomposition.md` describing how a real diff should ship as a
`decomposition.md`. You never write code, never split branches, never PR stack. Never code, never split branches, never run `/ship`.
run `/ship`. The output is the artifact and only the artifact.
## When to invoke **Don't run** on diffs that are ≤1 component + ≤30 min reader time +
no hard edges — output one line ("This is one PR. No decomposition
needed.") and stop. False slicing is worse than no slicing.
Run when a diff already exists (committed or working tree). Don't run on **Don't run** before code exists. Tell the user to write a real diff
single-component, sub-30-min-reader-time diffs — produce the one-line first.
"this is one PR" verdict and stop. False slicing is worse than no slicing.
If invoked before any code has been written, stop and say so: nothing Out of v1: `rollout.md`, spill-check, `/ship`/`/review` integration,
to decompose, re-run against a real diff. SYSTEM.md scaffolder.
Out of v1: `rollout.md`, spill-check, `/ship` and `/review` integration, ## Step 0 — Detect
SYSTEM.md scaffolding.
## Step 0 — Detect repo state 1. Repo root: `git rev-parse --show-toplevel`.
2. Base: `gh pr view --json baseRefName -q .baseRefName`, then
`origin/main`, then `origin/master`. AskUserQuestion if unresolved.
3. Head: `git rev-parse --abbrev-ref HEAD`.
4. Plan source: arg path → `~/.gstack/projects/<slug>/...-design-*.md`
→ AskUserQuestion (paste / path / diff-only).
1. **Repo root:** `git rev-parse --show-toplevel`. Ask via Echo each value in one line. Facts only.
AskUserQuestion if not in a git repo; stop if unavailable.
2. **Base branch:** try `gh pr view --json baseRefName -q .baseRefName`,
then `origin/main`, then `origin/master`. Ask if unresolved.
3. **Head ref:** `git rev-parse --abbrev-ref HEAD`. If detached or on
the base, ask whether to use a description-only input.
4. **Plan source:** in order, (a) plan-file path from args; (b)
`~/.gstack/projects/<slug>/...-design-*.md` for this branch
(mirror `plan-eng-review`'s lookup); (c) AskUserQuestion for
paste / path / diff-only.
State each detected value back in one line. Facts, not prose.
## Step 1 — Read SYSTEM.md if present ## Step 1 — Read SYSTEM.md if present
@ -67,33 +60,28 @@ State each detected value back in one line. Facts, not prose.
test -f SYSTEM.md && cat SYSTEM.md || echo "(no SYSTEM.md — using path heuristics)" test -f SYSTEM.md && cat SYSTEM.md || echo "(no SYSTEM.md — using path heuristics)"
``` ```
If present: parse YAML frontmatter, build a path→component map If present: parse YAML, build path→component map (longest-path-wins),
(longest-path-wins), build the contract graph (`rollout-edge: hard` build contract graph (`rollout-edge: hard` edges drive coordinated-
edges drive coordinated-deploy warnings). deploy warnings later).
If absent: fall back to one slice per top-level directory touched. If absent: one component = one top-level directory of change.
Never invent a SYSTEM.md from heuristics.
## Step 2 — Enumerate the diff ## Step 2 — Enumerate the diff
Capture committed + staged + unstaged + untracked work:
```bash ```bash
# Tracked changes vs base. NO triple-dot — `git diff <base>` compares git diff --name-status "<base>" # tracked: committed + staged + unstaged
# the working tree to <base> and includes everything not yet pushed.
git diff --name-status "<base>"
git diff --numstat "<base>" git diff --numstat "<base>"
git ls-files --others --exclude-standard # untracked, treat as fully added git ls-files --others --exclude-standard # untracked, treat as fully added
``` ```
Union and deduplicate by path. If empty, print "No changes between Use `git diff <base>` (no triple-dot) so working-tree changes count.
<base> and the current working state. Nothing to decompose." and stop. Union, dedupe by path. Empty → "Nothing to decompose" + stop.
For >200 files, warn and ask before proceeding. >200 files → warn + ask before proceeding.
Bucket each file: with SYSTEM.md, via the path map (unmatched → `(unmapped)` Bucket each file: with SYSTEM.md, via the path map (unmatched →
bucket, flagged in output). Without, by top-level directory. `(unmapped)`, flagged). Without, by top-level directory.
## Step 3 — Light-touch import discovery ## Step 3 — Light import discovery
```bash ```bash
grep -E "^import .* from |^const .* = require\(" <file> # TS/JS grep -E "^import .* from |^const .* = require\(" <file> # TS/JS
@ -101,66 +89,58 @@ grep -E "^(from |import )" <file> # Python
grep -E "^import " <file> # Go grep -E "^import " <file> # Go
``` ```
Resolve each import to a component (or top-level dir). Record directed Resolve each import to a component. Record directed edges. External
edges `<file's component> → <imported component>`. Unresolvable imports or ambiguous imports: log + skip.
(external packages, ambiguous paths) are no-ops — log, don't fail.
## Step 4 — Propose the slice stack ## Step 4 — Propose the stack
Rules in priority order: Priority order:
1. **`rollout-edge: hard`** (SYSTEM.md): if BOTH sides of a hard contract 1. `rollout-edge: hard` (SYSTEM.md): both-sides-changed → one slice
have changed files, those files merge into one slice tagged tagged "coordinated deploy required — \<breaks-if reason\>".
"coordinated deploy required — <breaks-if reason>". 2. Topological by import edges. Cycles flagged + merged.
2. **Topological by import edges:** a slice ships after every slice it 3. `rollout-order` (lower first) breaks ties.
imports from. Cycles flagged + merged. 4. `leaf-util` / `types-only` float to slice 0.
3. **`rollout-order`** breaks ties (lower first). 5. Alphabetical for remaining ties.
4. **`leaf-util` / `types-only`** float to slice 0.
5. **Alphabetical** on remaining ties. Predictable > clever.
Per slice, compute: file list, lines +/-, dependencies, reader-time Per slice: files, lines +/-, dependencies, reader-time
(`ceil(lines/80) + ceil(files/5)` min; cap each slice at 30 min — split (`ceil(lines/80) + ceil(files/5)` min; cap 30 min — split or flag),
or flag if exceeded), reader guide (2-4 sentences, tired-reviewer voice). reader guide (2-4 sentences, tired-reviewer voice).
**One-PR escape:** if the diff is ≤1 component, ≤30 min reader time, **One-PR escape:** ≤1 component + ≤30 min + no hard edges → one-line
no hard edges, write a one-line decomposition.md ("This is one PR. No decomposition.md + exit.
decomposition needed.") and exit.
## Step 5 — Reconciliation flags (informational) ## Step 5 — Reconciliation flags (informational, never blocking)
With SYSTEM.md present, compute and print (never blocking):
With SYSTEM.md present, print:
- `import-without-contract`: A imports B but no contract declared. - `import-without-contract`: A imports B but no contract declared.
- `contract-without-imports`: contract declared with no supporting - `contract-without-imports`: contract declared, no supporting import
import edge AND no `note: runtime-only`. edge, no `note: runtime-only`.
- `rollout-order-inversion`: declared order disagrees with discovered. - `rollout-order-inversion`: declared order ≠ discovered order.
## Step 6 — Artifact location ## Step 6 — Artifact location
AskUserQuestion: AskUserQuestion:
- In-repo: `.gstack/plan-rollout/<branch-slug>-decomposition.md`
- User scope: `~/.gstack/projects/<repo-slug>/<branch-slug>-decomposition.md`
| Option | Path | Recommend in-repo when other `.gstack/` planning artifacts already
|--------|------| exist on the branch; user scope otherwise.
| In-repo | `.gstack/plan-rollout/<branch-slug>-decomposition.md` |
| User scope | `~/.gstack/projects/<repo-slug>/<branch-slug>-decomposition.md` |
Recommend in-repo when other `.gstack/` planning artifacts exist on the
branch; user scope otherwise.
## Step 7 — Write decomposition.md ## Step 7 — Write decomposition.md
```markdown ```markdown
# Decomposition: <branch-name> # Decomposition: <branch>
**Base:** <base> **Head:** <head> **Diff:** <N files, +A / -D> **Base:** <base> **Head:** <head> **Diff:** <N files, +A / -D>
**SYSTEM.md:** <present | absent — heuristics used> **SYSTEM.md:** <present | absent — heuristics used>
**Generated:** <ISO timestamp> **By:** /plan-rollout vX.Y.Z **Generated:** <ISO> **By:** /plan-rollout vX.Y.Z
## Verdict ## Verdict
<One paragraph. "This is one PR — no decomposition needed." | "Ship as <One paragraph. "This is one PR — no decomposition needed." | "Ship
N PRs in this order. Total reviewer time: ~M min." | "Stop. <issue>. Do as N PRs in this order. Total reviewer time: ~M min." | "Stop.
<X> first."> <issue>. Do <X> first.">
## Slices ## Slices
@ -170,35 +150,30 @@ N PRs in this order. Total reviewer time: ~M min." | "Stop. <issue>. Do
**Coordinated deploy:** <only if hard-edge applies> **Coordinated deploy:** <only if hard-edge applies>
**Reader guide.** <2-4 sentences> **Reader guide.** <2-4 sentences>
### Slice 2: ...
## Reconciliation flags (informational) ## Reconciliation flags (informational)
- ... - ...
(Emit only if SYSTEM.md present and ≥1 flag fired.) (Emit only if SYSTEM.md present and ≥1 flag fired.)
## What's NOT in this decomposition ## What's NOT in this decomposition
<Excluded on purpose. "All changed files allocated." if none.> <Excluded files. "All changed files allocated." if none.>
``` ```
Write the file, print its path, stop. Do not implement, do not split Write the file, print its path, stop.
the branch, do not run `/ship`.
## Self-check before exit ## Self-check before exit
1. Every changed file in exactly one slice (or flagged `(unmapped)`). 1. Every file → exactly one slice (or `(unmapped)` flagged).
2. No slice depends on a later slice (no cycles). 2. No slice depends on a later slice.
3. Verdict matches the math — if reader time is 4 min on 2 files, the 3. Verdict matches the math. 4 min on 2 files = one PR, not a stack.
verdict is "one PR," not a stack.
4. With SYSTEM.md, every slice maps to a real component name. 4. With SYSTEM.md, every slice maps to a real component name.
If a check fails and you can't fix the decomposition, write the file If a check fails and you can't fix it, write the file with the
with the failure flagged in the verdict. failure flagged in the verdict.
## Limits ## Limits
- Does NOT enforce or split branches — produces a doc. - Produces a doc — never enforces, never splits branches.
- Does NOT validate `breaks-if` claims — human judgment. - Does not validate `breaks-if` claims (human judgment).
- Does NOT scaffold SYSTEM.md (deferred to v2). - Reader-time is heuristic; v1 has no calibration data.
- Reader-time estimates are heuristic; v1 has no calibration data. - Mostly-one-component diffs with stray files: one PR with a "stray
- Mostly-one-component diffs with stray files: call them one PR with a files" flag, not a forced 2-slice stack.
"stray files" flag. Don't force a 2-slice stack.