- name
SKILL.md
스킬 파일은 게시자의 저장소에 그대로 있습니다.
복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add ericrisco/rsc-harness --skill asdd -a cursor -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add ericrisco/rsc-harness --skill asdd -a claude-code -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add ericrisco/rsc-harness --skill asdd -a codex -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add ericrisco/rsc-harness --skill asdd -a grok -y복사한 메시지를 Grok Bot 채팅에 보냅니다. Bot이 GitHub에서 이 SKILL.md를 가져와 모든 Bot이 공유하는 스킬에 추가합니다.
Install this skill: https://github.com/ericrisco/rsc-harness/tree/HEAD/skills/asdd게시자 제공
The front door for letting an agent build for hours without coming back with a Frankenstein: intent in, shipped-and-verified software out, every decision recorded in 02-DOCS/wiki/sdd/.
Why it exists. Classic SDD reviewed at the end. On paper it checked the spec; in a long autonomous run, the only thing that bit for hours was the test — and tests prove the code works, not that it does what was asked (a real run: 8 hours, 4,500 green tests, and a dropped token plus a QR nobody requested). ASDD keeps the phases and changes two things: the spec must prove itself, and the review moves inside every task, scaled by risk. The human stops reviewing everything and only takes the decisions the agent must not take alone.
This skill does not do a phase. It names the method, reads the register, places the request on the map and hands off. Each phase skill points at the next one.
request ─► decisor (answer · ftd · asdd)
│ asdd
1. BASE ─────► constitution + REVIEW.md (once per project)
2. SPEC ─────► specify (4 questions + out of scope) ─► clarify (gap checklist) ◄── HUMAN APPROVES
3. PLAN ─────► plan ─► tasks (criterion · risk forecast · check) ─► analyze
4. LOOP ─────► per task, in implement:
a build + self-check b rsc risk c review by tier
d verify findings e mandatory controls
f fix (max 3 rounds) g fix & record ─or─ park ─► DECISION QUEUE ◄── HUMAN
5. CLOSE ────► verify against main + rollback plan · closing review (whole branch vs spec) · explainer
SHIP ─────► remote: PR (self-merge only tier 0-1 + green CI + no blocking entry) │ no remote: park ◄── HUMAN
LEARN ────► finding outcomes · reverts → reviewer cases · repeated finding → rule
Where the human enters — three places only: approving the spec, answering the decision queue, approving a tier-2 merge. Everything else runs.
No ASDD phase edits the root CLAUDE.md: every artifact is indexed in 02-DOCS/wiki/index.md (the Knowledge map). The root CLAUDE.md is owned by harness and is tier 2 in rsc risk.
Every spec answers four questions, and spec:gate refuses one dated 2026-11-03 or later without them: what the user can do, what result they get (against a reference the human approved — a screenshot, a sketch, an expected API response), what it must respect (prior decisions, specs and behaviour; read from the brain when the project has one, else decisions.md), how it proves it (how the check runs, what evidence remains — "yes, I tested it" is not evidence). Plus an explicit out of scope: what the agent might add "just in case".
npx @ericrisco/rsc risk [--base <ref>] [paths…] classifies a change by what it touches and what it adds (the sello's path table plus fixed content patterns — password hashing, session cookies, payments, schema changes, secrets — so auth code in src/app.js is still auth; works with the sello off): tier 0 docs/copy → no reviewer; tier 1 ordinary code → one fresh-context reviewer; tier 2 auth, billing, CI workflows, migrations, secrets, harness config → the three-refuter panel and human approval. An agent's approval never counts as a human's. Enforced at push: a tier-2 branch leaves the machine only with a spec linked to it that passes rsc spec gate and a panel recorded with rsc review ledger panel <slug>/<task> --lenses correctness,security,tests.
npx @ericrisco/rsc review ledger holds it to the rules that stopped Anthropic's 50-round reviews: round <slug>/<task> refuses a 4th round (rethink the approach or park the task), record marks a finding already raised as a repeat that is never raised again, outcome closes each finding as fixed|false|intentional|irrelevant, stats measures the noise. Flag the bug class, not the line; from round 2 re-review only the new diff.
Tier 2, a contradiction with a recorded decision, a gap that would make the build unsafe, or no convergence in 3 rounds: the task goes to the decision queue (## Decision queue in progress/<slug>.md) with its evidence, and the agent continues with the independent tasks. The run never waits at 2 a.m. for an answer.
Every entry carries a kind, one line each, in exactly this form (no bold, no other bullet):
- [blocking] Q3 — <what must be decided>, <evidence>, <task>
- [review-after] Q4 — <assumption taken>, <where it is recorded>, <task>
blocking — tier 2, a contradiction with a recorded decision, no convergence in 3 rounds, a hard failure. It stops a self-merge.review-after — clarify's recorded assumptions, a spec reference the agent had to write itself, a provisional constitution ratification. It never stops a merge; it is listed in the PR body (or the parked summary) for the human.The new-feature gate (hard). The moment the user is thinking about a new feature or change — "add…", "build…", "it should also…", "quiero añadir…" — and the decisor chose this lane, it goes to
specifyfirst, even if a stack skill also fired. No feature code is written — by any skill — until a spec AND a plan exist and are approved. Small authorised changes go to../ftd/SKILL.md, which escalates here whenrsc risksays tier 2 or the change contradicts a recorded decision.
constitution first (it decides the stack), then sdd-init.02-DOCS/wiki/sdd/config.yaml and this is non-trivial? → sdd-init. No constitution, or status: draft? → constitution once (it also drafts REVIEW.md).specify.specify. Spec with gaps? → clarify.plan, then tasks, then analyze.implement (the per-task loop; parallel / worktrees when useful).verify (closing mode, main merged in), then review (closing review of that exact state), then ship.debug, then resume.Cannot tell the phase? Ask one question: "Do we have a written spec for this yet?"
Skip honestly: constitution runs once per project; clarify and analyze are gates, not paperwork — pass through only when the change is genuinely tiny, and say so.
The user says "take it all the way" once (or execution_mode: automatic under sdd: in config.yaml, set by sdd-init) and the chain runs end to end without asking to continue between phases, still writing every artifact. The up-front yes satisfies the new-feature gate.
Autopilot does not stop the run for questions — it parks: real ambiguity, tier 2, a contradiction with a recorded decision or a non-converging task go to the decision queue while independent work continues. It stops only for a hard failure nothing else can proceed past, and for destructive or irreversible actions.
In autopilot, per phase:
constitution ratifies provisionally → review-after entry.specify uses a checkable reference it wrote itself (expected output, sample response) → review-after entry.clarify records its assumptions (suposición tomada) → review-after entries.implement parks blocking items and continues with the independent tasks.ship lands by the rule below.Never hand the turn back mid-run. No "¿sigo?" / "shall I continue?": not between phases, not while reviewers run. Background reviewers are waited for (their completion notice, or run them in the foreground); ending the turn to wait ends a headless run. A later "continue" from the person resumes the run; it is not approval for a tier-2 merge, which needs an explicit yes to that merge.
Landing — there is always a legal path. A remote exists → open a PR; self-merge only when rsc risk says tier 0-1, CI is green and no blocking entry is open; review-after entries go into the PR body. No remote → park: leave the branch committed, write the explainer, the open entries and the exact merge command for the human into progress/<slug>.md, and stop. Never merge locally around the branch guard: when rsc main status says closed: true, the guard denies it.
Narrate in the orient voice: name each stage as it passes and show its artifact, one line each.
Read technical_level in 02-DOCS/wiki/harness/user-profile.md. It picks the words (technical, or plain with analogies), never whether the gates exist. No profile → analogies, ask once "technical or with analogies?", persist it (that is init's job; asdd honors it). At gates, ask only what changes what gets built, one question at a time, recommendation first.
Each phase declares a tier — heavy (constitution, plan, analyze, review, debug), balanced (specify, clarify, tasks, implement, verify), light (ship, worktrees, sdd-init) — resolved to a model in config.yaml under models. Off by default (models.enabled: false). Never switch unasked, never claim a switch a tool can't make; the dispatcher itself stays on the session model. Protocol: references/model-routing.md.
02-DOCS/wiki/sdd/
├── config.yaml ← runtime calibration (sdd-init)
├── constitution.md ← non-negotiables (once)
├── proposals/<slug>.md ← optional pre-execution briefing
├── specs/<slug>.md ← one spec per feature (four questions + out of scope)
├── plans/<slug>.md ← plan + tasks
├── analysis/<slug>.md ← analyze's cross-artifact report
├── progress/<slug>.md ← append-only loop ledger + ## Decision queue
├── verifications/<slug>-YYYY-MM-DD.md
├── reviews/<slug>.md ← closing review record
├── review-evals/<sha>.md ← one case per revert that escaped review (`rsc review escapes`)
├── archive/<slug>/
├── sessions/<date>-<slug>.md
└── decisions.md ← append-only: every decision, and the task it was taken in
REVIEW.md ← project root: how this repo is judged
.rsc/review-ledger.jsonl ← findings, outcomes, rounds (tool-written)
The directory keeps its sdd/ name: existing projects keep working. Index it in 02-DOCS/wiki/index.md under the sdd/ topic — never in the root CLAUDE.md; the harness keeps it honest.
ASDD is process, not stack: plan defers stack specifics, implement borrows the stack skill's testing approach, verify runs its checks (../fastapi/SKILL.md, ../nextjs/SKILL.md, ../go/SKILL.md, ../postgresdb/SKILL.md, ../flutter/SKILL.md; UI → ../design/SKILL.md). Choose skills through .rsc/skill-registry.json, digest them into 4-5 compact rules per subagent brief, never load the catalog.
Every phase ends with this block so the dispatcher can chain without interpreting prose:
{
"status": "complete|blocked|failed",
"executive_summary": "one short paragraph",
"artifact": "path/to/artifact-or-none",
"next_recommended": "sdd-init|constitution|specify|clarify|plan|tasks|analyze|implement|verify|review|ship",
"risk": "low|medium|high",
"model": { "tier": "heavy|balanced|light", "resolved": "model-id", "routing": "on|off" },
"skill_resolution": { "used": [], "missing": [], "fallback": [], "compact_rules": [] },
"evidence": []
}
A run stopped mid-flight writes 02-DOCS/wiki/sdd/sessions/<date>-<slug>.md instead: stage, artifacts, last verdict, done and parked tasks, the decision queue, next steps.
sdd-init, constitution, then specify. Empty repo → constitution first (it decides the stack), then sdd-init.specify (proposal first if risky or architectural).../ftd/SKILL.md.Then follow the arrows: each phase ends by pointing at the next, all the way to ship.
Use when a feature or substantial change should go from idea to shipped, verified software and an agent may run it for hours on its own — the ASDD (Agent Spec-Driven Development) dispatcher and front
---name: asdddescription: Use when a feature or substantial change should go from idea to shipped, verified software and an agent may…---# skills/asdd/SKILL.md개요
Use when a feature or substantial change should go from idea to shipped, verified software and an agent may run it for hours on its own — the ASDD (Agent Spec-Driven Development) dispatcher and front door, in any language. A spec that must prove itself, review inside every task scaled by `rsc risk`, a decision queue for what the agent must not decide alone. Routes constitution -> specify -> clarify -> plan -> tasks -> analyze -> implement (verify + review per task) -> closing -> ship. Successor of `sdd`. NOT a single phase (it dispatches), NOT small authorised changes (that is `ftd`), NOT the workspace harness (that is `harness`).
FAQ
게시자에게서 skills/asdd/SKILL.md를 다운로드하거나 경로를 복사해 저장소를 엽니다. PlugMCP는 스킬을 목록에 올릴 뿐 파일을 호스팅하지 않습니다.
게시자가 https://github.com/ericrisco/rsc-harness에서 관리합니다.
Claude, Cursor, Codex, Grok Build는 게시자의 저장소에서 추가한 SKILL.md를 읽을 수 있습니다. Grok Bot은 채팅에서 스킬의 GitHub 폴더 링크를 보내면 설치합니다.