/split: per-subtask repo routing and two-phase proposals

[JPDuchesne]

Summary

• /split becomes plan/apply: --dry runs the one agent pass (full annotated repo menu, per-subtask repo field, existing: schema, deterministic # possible match: discovery) and stages an editable fenced-yaml ## Subtasks section in the plan body; --apply executes exactly that section with no agent call — create per repo, adopt parentless existing: issues / reference parented ones, Intended repo: fallback + warning where the App isn't installed, close stale, fully qualified Depends on: owner/repo#n — then rewrites the section into a linked map (canonicity transfers to the sub-issues). Bare /split does both.
• /build is state-aware on issues: refuses on a staged (unapplied) spec, proceeds with a note when open sub-issues exist.
• /build --split keys dependencies by owner/repo#n, skips undrivable nodes (intended-repo fallbacks, adopted/referenced externals from the applied map) with explicit warnings, and reports dependents blocked — including on open external dependencies.
• New normative docs: docs/commands.md (per-surface reference, refusals verbatim) and docs/plan-lifecycle.md (end-to-end narrative + body conventions); README/architecture trimmed to pointers.

Closes#2

Test plan

• bundle exec rake test — 72 tests, 0 failures (new coverage: routing, fallback+warning, dry stages without creating, hand-edited apply without agent, refusals, adopt vs reference, possible-match annotation, skip/block checklist, /build guards)
• Live: /split --dry on plans#5, hand-edit, --apply, cross-repo children; /build guard behaviors

Made with Cursor

[JPDuchesne]

Summary

• /split becomes plan/apply: --dry runs the one agent pass (full annotated repo menu, per-subtask repo field, existing: schema, deterministic # possible match: discovery) and stages an editable fenced-yaml ## Subtasks section in the plan body; --apply executes exactly that section with no agent call — create per repo, adopt parentless existing: issues / reference parented ones, Intended repo: fallback + warning where the App isn't installed, close stale, fully qualified Depends on: owner/repo#n — then rewrites the section into a linked map (canonicity transfers to the sub-issues). Bare /split does both.
• /build is state-aware on issues: refuses on a staged (unapplied) spec, proceeds with a note when open sub-issues exist.
• /build --split keys dependencies by owner/repo#n, skips undrivable nodes (intended-repo fallbacks, adopted/referenced externals from the applied map) with explicit warnings, and reports dependents blocked — including on open external dependencies.
• New normative docs: docs/commands.md (per-surface reference, refusals verbatim) and docs/plan-lifecycle.md (end-to-end narrative + body conventions); README/architecture trimmed to pointers.

Closes#2

Test plan

• bundle exec rake test — 72 tests, 0 failures (new coverage: routing, fallback+warning, dry stages without creating, hand-edited apply without agent, refusals, adopt vs reference, possible-match annotation, skip/block checklist, /build guards)
• Live: /split --dry on plans#5, hand-edit, --apply, cross-repo children; /build guard behaviors

Made with Cursor

[JPDuchesne]

Summary

• /split becomes plan/apply: --dry runs the one agent pass (full annotated repo menu, per-subtask repo field, existing: schema, deterministic # possible match: discovery) and stages an editable fenced-yaml ## Subtasks section in the plan body; --apply executes exactly that section with no agent call — create per repo, adopt parentless existing: issues / reference parented ones, Intended repo: fallback + warning where the App isn't installed, close stale, fully qualified Depends on: owner/repo#n — then rewrites the section into a linked map (canonicity transfers to the sub-issues). Bare /split does both.
• /build is state-aware on issues: refuses on a staged (unapplied) spec, proceeds with a note when open sub-issues exist.
• /build --split keys dependencies by owner/repo#n, skips undrivable nodes (intended-repo fallbacks, adopted/referenced externals from the applied map) with explicit warnings, and reports dependents blocked — including on open external dependencies.
• New normative docs: docs/commands.md (per-surface reference, refusals verbatim) and docs/plan-lifecycle.md (end-to-end narrative + body conventions); README/architecture trimmed to pointers.

Closes#2

Test plan

• bundle exec rake test — 72 tests, 0 failures (new coverage: routing, fallback+warning, dry stages without creating, hand-edited apply without agent, refusals, adopt vs reference, possible-match annotation, skip/block checklist, /build guards)
• Live: /split --dry on plans#5, hand-edit, --apply, cross-repo children; /build guard behaviors

Made with Cursor

[JPDuchesne]

Summary

• /split becomes plan/apply: --dry runs the one agent pass (full annotated repo menu, per-subtask repo field, existing: schema, deterministic # possible match: discovery) and stages an editable fenced-yaml ## Subtasks section in the plan body; --apply executes exactly that section with no agent call — create per repo, adopt parentless existing: issues / reference parented ones, Intended repo: fallback + warning where the App isn't installed, close stale, fully qualified Depends on: owner/repo#n — then rewrites the section into a linked map (canonicity transfers to the sub-issues). Bare /split does both.
• /build is state-aware on issues: refuses on a staged (unapplied) spec, proceeds with a note when open sub-issues exist.
• /build --split keys dependencies by owner/repo#n, skips undrivable nodes (intended-repo fallbacks, adopted/referenced externals from the applied map) with explicit warnings, and reports dependents blocked — including on open external dependencies.
• New normative docs: docs/commands.md (per-surface reference, refusals verbatim) and docs/plan-lifecycle.md (end-to-end narrative + body conventions); README/architecture trimmed to pointers.

Closes#2

Test plan

• bundle exec rake test — 72 tests, 0 failures (new coverage: routing, fallback+warning, dry stages without creating, hand-edited apply without agent, refusals, adopt vs reference, possible-match annotation, skip/block checklist, /build guards)
• Live: /split --dry on plans#5, hand-edit, --apply, cross-repo children; /build guard behaviors

Made with Cursor

[JPDuchesne]

Summary

• /split becomes plan/apply: --dry runs the one agent pass (full annotated repo menu, per-subtask repo field, existing: schema, deterministic # possible match: discovery) and stages an editable fenced-yaml ## Subtasks section in the plan body; --apply executes exactly that section with no agent call — create per repo, adopt parentless existing: issues / reference parented ones, Intended repo: fallback + warning where the App isn't installed, close stale, fully qualified Depends on: owner/repo#n — then rewrites the section into a linked map (canonicity transfers to the sub-issues). Bare /split does both.
• /build is state-aware on issues: refuses on a staged (unapplied) spec, proceeds with a note when open sub-issues exist.
• /build --split keys dependencies by owner/repo#n, skips undrivable nodes (intended-repo fallbacks, adopted/referenced externals from the applied map) with explicit warnings, and reports dependents blocked — including on open external dependencies.
• New normative docs: docs/commands.md (per-surface reference, refusals verbatim) and docs/plan-lifecycle.md (end-to-end narrative + body conventions); README/architecture trimmed to pointers.

Closes#2

Test plan

• bundle exec rake test — 72 tests, 0 failures (new coverage: routing, fallback+warning, dry stages without creating, hand-edited apply without agent, refusals, adopt vs reference, possible-match annotation, skip/block checklist, /build guards)
• Live: /split --dry on plans#5, hand-edit, --apply, cross-repo children; /build guard behaviors

Made with Cursor

[JPDuchesne]

Summary

• /split becomes plan/apply: --dry runs the one agent pass (full annotated repo menu, per-subtask repo field, existing: schema, deterministic # possible match: discovery) and stages an editable fenced-yaml ## Subtasks section in the plan body; --apply executes exactly that section with no agent call — create per repo, adopt parentless existing: issues / reference parented ones, Intended repo: fallback + warning where the App isn't installed, close stale, fully qualified Depends on: owner/repo#n — then rewrites the section into a linked map (canonicity transfers to the sub-issues). Bare /split does both.
• /build is state-aware on issues: refuses on a staged (unapplied) spec, proceeds with a note when open sub-issues exist.
• /build --split keys dependencies by owner/repo#n, skips undrivable nodes (intended-repo fallbacks, adopted/referenced externals from the applied map) with explicit warnings, and reports dependents blocked — including on open external dependencies.
• New normative docs: docs/commands.md (per-surface reference, refusals verbatim) and docs/plan-lifecycle.md (end-to-end narrative + body conventions); README/architecture trimmed to pointers.

Closes#2

Test plan

• bundle exec rake test — 72 tests, 0 failures (new coverage: routing, fallback+warning, dry stages without creating, hand-edited apply without agent, refusals, adopt vs reference, possible-match annotation, skip/block checklist, /build guards)
• Live: /split --dry on plans#5, hand-edit, --apply, cross-repo children; /build guard behaviors

Made with Cursor

[JPDuchesne]

Summary

• /split becomes plan/apply: --dry runs the one agent pass (full annotated repo menu, per-subtask repo field, existing: schema, deterministic # possible match: discovery) and stages an editable fenced-yaml ## Subtasks section in the plan body; --apply executes exactly that section with no agent call — create per repo, adopt parentless existing: issues / reference parented ones, Intended repo: fallback + warning where the App isn't installed, close stale, fully qualified Depends on: owner/repo#n — then rewrites the section into a linked map (canonicity transfers to the sub-issues). Bare /split does both.
• /build is state-aware on issues: refuses on a staged (unapplied) spec, proceeds with a note when open sub-issues exist.
• /build --split keys dependencies by owner/repo#n, skips undrivable nodes (intended-repo fallbacks, adopted/referenced externals from the applied map) with explicit warnings, and reports dependents blocked — including on open external dependencies.
• New normative docs: docs/commands.md (per-surface reference, refusals verbatim) and docs/plan-lifecycle.md (end-to-end narrative + body conventions); README/architecture trimmed to pointers.

Closes#2

Test plan

• bundle exec rake test — 72 tests, 0 failures (new coverage: routing, fallback+warning, dry stages without creating, hand-edited apply without agent, refusals, adopt vs reference, possible-match annotation, skip/block checklist, /build guards)
• Live: /split --dry on plans#5, hand-edit, --apply, cross-repo children; /build guard behaviors

Made with Cursor

[JPDuchesne]

Summary

• /split becomes plan/apply: --dry runs the one agent pass (full annotated repo menu, per-subtask repo field, existing: schema, deterministic # possible match: discovery) and stages an editable fenced-yaml ## Subtasks section in the plan body; --apply executes exactly that section with no agent call — create per repo, adopt parentless existing: issues / reference parented ones, Intended repo: fallback + warning where the App isn't installed, close stale, fully qualified Depends on: owner/repo#n — then rewrites the section into a linked map (canonicity transfers to the sub-issues). Bare /split does both.
• /build is state-aware on issues: refuses on a staged (unapplied) spec, proceeds with a note when open sub-issues exist.
• /build --split keys dependencies by owner/repo#n, skips undrivable nodes (intended-repo fallbacks, adopted/referenced externals from the applied map) with explicit warnings, and reports dependents blocked — including on open external dependencies.
• New normative docs: docs/commands.md (per-surface reference, refusals verbatim) and docs/plan-lifecycle.md (end-to-end narrative + body conventions); README/architecture trimmed to pointers.

Closes#2

Test plan

• bundle exec rake test — 72 tests, 0 failures (new coverage: routing, fallback+warning, dry stages without creating, hand-edited apply without agent, refusals, adopt vs reference, possible-match annotation, skip/block checklist, /build guards)
• Live: /split --dry on plans#5, hand-edit, --apply, cross-repo children; /build guard behaviors

Made with Cursor