@@ -6,7 +6,7 @@ description: Run a spec session on a GitHub issue — turn a request into a feat
66# Spec session
77
88You are writing the body of a ` feature:* ` or ` task:* ` issue on behalf of the
9- maintainer. The rules in ` docs/agent-rules/delivery.md ` are binding; the ones
9+ maintainer. The rules in ` docs/internal/ agent-rules/delivery.md ` are binding; the ones
1010that matter most here are 3 (the body is the spec), 4 (reconcile first), 5
1111(never rewrite a reporter's issue) and 6 (outcomes, not implementation).
1212
@@ -56,7 +56,7 @@ whenever the codebase can answer. The `interview-me` and `grill-me` skills
5656describe the technique; use it.
5757
5858** Creating a feature from a request** (` request:new ` issue given):
59- interview for the business sections of ` docs/templates/feature.md ` , then
59+ interview for the business sections of ` docs/internal/ templates/feature.md ` , then
6060
6161``` bash
6262gh issue create --title " <title>" --label feature:spec --body-file < file>
@@ -73,13 +73,13 @@ questions remain; the feature does not leave `feature:spec` until it is empty.
7373** ` technical ` ** (feature delivered as one PR): fill the Technical spec
7474section. Before writing it, ask whether any decision here constrains more
7575than one future change or would be expensive to reverse. Each such decision
76- becomes an ADR: draft it in ` docs/adr/ ` at status _ Proposed_ on a branch, and
76+ becomes an ADR: draft it in ` docs/internal/ adr/ ` at status _ Proposed_ on a branch, and
7777add its line to Decisions. Tell the maintainer the feature cannot leave
7878` feature:spec ` until that ADR is accepted.
7979
8080** ` split ` ** : interview for the task list — vertical slices, each one a PR a
8181single agent can land, ordered so every task depends only on earlier ones.
82- For each task, write a body from ` docs/templates/task.md ` with Scope,
82+ For each task, write a body from ` docs/internal/ templates/task.md ` with Scope,
8383Technical spec, Done when, Out of scope and Depends on filled in, then:
8484
8585``` bash
0 commit comments