Skip to content

Commit 06fbdae

Browse files
committed
chore(skills): follow the docs/internal split (#134)
1 parent 471dbf4 commit 06fbdae

3 files changed

Lines changed: 9 additions & 9 deletions

File tree

.claude/skills/deliver/SKILL.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Claim and implement a ready issue (task:ready, bug:ready, or featur
55

66
# Deliver a ready issue
77

8-
Rules 1, 2, 3 and 9 in `docs/agent-rules/delivery.md` govern this skill: act
8+
Rules 1, 2, 3 and 9 in `docs/internal/agent-rules/delivery.md` govern this skill: act
99
only on ready labels, the assignee is the claim, build from the body, done is
1010
defined per kind.
1111

@@ -68,9 +68,9 @@ git fetch origin bug/<N>-repro && git switch -c bug/<N> origin/bug/<N>-repro
6868
## 4. Build
6969

7070
Implement the Technical spec. Every test title under Tests is a claim to
71-
prove, and `docs/agent-rules/testing.md` says what proving means. Reread the
71+
prove, and `docs/internal/agent-rules/testing.md` says what proving means. Reread the
7272
files named under Rules in play before touching the code they cover. New or
73-
changed events need their `docs/EVENTS.md` entry in the same change.
73+
changed events need their entries in both `docs/EVENTS.md` and `docs/internal/EVENTS.md` in the same change.
7474

7575
Run `pnpm check` before opening the PR.
7676

.claude/skills/spec-session/SKILL.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ description: Run a spec session on a GitHub issue — turn a request into a feat
66
# Spec session
77

88
You 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
1010
that 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
5656
describe 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
6262
gh 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
7474
section. Before writing it, ask whether any decision here constrains more
7575
than 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
7777
add 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
8181
single 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,
8383
Technical spec, Done when, Out of scope and Depends on filled in, then:
8484

8585
```bash

.claude/skills/triage-bug/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@ description: Triage a bug:triage issue — reproduce it as a failing test, find
55

66
# Triage a bug
77

8-
You produce a report, not a fix. Rule 8 in `docs/agent-rules/delivery.md`
9-
defines the report; `docs/agent-rules/testing.md` defines what a reproduction
8+
You produce a report, not a fix. Rule 8 in `docs/internal/agent-rules/delivery.md`
9+
defines the report; `docs/internal/agent-rules/testing.md` defines what a reproduction
1010
is worth.
1111

1212
Argument: an issue number. Without one, take the oldest:

0 commit comments

Comments
 (0)