Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions .claude/commands/spec-dc.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,18 @@ If the user provides or mentions visual references (images, PDFs, designs, layou

## Phase 2 — Write the specification

### Output language

Write the spec **in the language of the feature request**, resolved in this order: (1) the
language of the feature description in `$ARGUMENTS`; (2) if that is mixed or unclear, the
language the user used in the clarifying Q&A; (3) if still ambiguous, the repository's primary
language (infer it from `AGENTS.md` / `CONTEXT.md` / existing docs); (4) otherwise English.
A Portuguese request produces a Portuguese spec, an English request an English spec.

This applies to the spec's **prose** — stories, requirements, criteria, and tests. **Keep the
seven section headings exactly as written in the template below**, and the filename slug in
ASCII kebab-case (no accents): both are structural anchors `/plan-dc` relies on.

Comment thread
coderabbitai[bot] marked this conversation as resolved.
Create the file at:

```text
Expand Down Expand Up @@ -175,6 +187,9 @@ faithful to the request:
- faithful to the request — nothing invented, nothing dropped

Do NOT judge product merit and do NOT invent requirements the request didn't ask for.
The spec is expected to be in the request's language (it may not be English) — do not treat a
non-English spec as a defect, but DO verify its language matches the request (or the documented
fallback) and flag a spec written in the wrong language.

If the spec passes, reply with ONLY the word: APPROVED. Otherwise, a detailed report of every
defect with the exact section / file / request line, and a concrete fix.
Expand Down
1 change: 1 addition & 0 deletions .context/decisions/020-spec-plan-execute-workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -159,6 +159,7 @@ a manual/future final step (update `CONTEXT.md` via `/setup-context`, ADRs via
|---------|------|---------|
| 1.0 | 2026-07-01 | Initial decision — spec/plan/execute trio, ADR review in plan, dual reviewers, non-destructive retire of the PRP flow |
| 1.1 | 2026-07-07 | Added a dual review loop to `/spec-dc` (scoped to well-formedness/fidelity, never product merit) after tech-lead review — the workshop had none |
| 1.2 | 2026-07-17 | `/spec-dc` writes the spec in the **language of the original request** (Portuguese request → Portuguese spec; defaults to the repo's primary language, then English). Prose only — the seven section headings and the filename slug stay ASCII structural anchors `/plan-dc` relies on. `/plan-dc` and `/execute-dc` are unchanged (English) |

## Related
- ADR-004: Claude Code Integration via Slash Commands — this supersedes the PRP pair as the feature-development flow
Expand Down
15 changes: 15 additions & 0 deletions templates/.claude/commands/spec-dc.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,18 @@ If the user provides or mentions visual references (images, PDFs, designs, layou

## Phase 2 — Write the specification

### Output language

Write the spec **in the language of the feature request**, resolved in this order: (1) the
language of the feature description in `$ARGUMENTS`; (2) if that is mixed or unclear, the
language the user used in the clarifying Q&A; (3) if still ambiguous, the repository's primary
language (infer it from `AGENTS.md` / `CONTEXT.md` / existing docs); (4) otherwise English.
A Portuguese request produces a Portuguese spec, an English request an English spec.

This applies to the spec's **prose** — stories, requirements, criteria, and tests. **Keep the
seven section headings exactly as written in the template below**, and the filename slug in
ASCII kebab-case (no accents): both are structural anchors `/plan-dc` relies on.

Create the file at:

```text
Expand Down Expand Up @@ -175,6 +187,9 @@ faithful to the request:
- faithful to the request — nothing invented, nothing dropped

Do NOT judge product merit and do NOT invent requirements the request didn't ask for.
The spec is expected to be in the request's language (it may not be English) — do not treat a
non-English spec as a defect, but DO verify its language matches the request (or the documented
fallback) and flag a spec written in the wrong language.

If the spec passes, reply with ONLY the word: APPROVED. Otherwise, a detailed report of every
defect with the exact section / file / request line, and a concrete fix.
Expand Down
6 changes: 6 additions & 0 deletions templates/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -114,6 +114,12 @@ user asks — never auto-fire a workflow that commits, opens a PR, or writes fil
| `add-skill` | Add a skill guide |
| `add-command` | Create a custom command |

When running **`spec-dc`**, write the spec artifact in the **same language the user used to describe
the feature** (a Portuguese request produces a Portuguese spec), defaulting to the repository's primary
language, then English. This applies to the spec's prose only — keep the seven section headings **exactly as written in the
template**, and the filename slug in ASCII kebab-case; both are structural anchors that `plan-dc` relies
on. `plan-dc` and `execute-dc` stay in English.

When a workflow needs to clarify requirements, **ask the user with your structured-question tool**
(`AskUserQuestion` / `ask_user` / `question` / `cursor/ask_question` / `request_user_input`) rather than
assuming — present concrete options. Do not degrade to silent assumptions.
Expand Down
Loading