Skip to content

Commit 42115f4

Browse files
iaminaweclaude
andcommitted
docs: clarify 00N-SYSTEM.md naming pattern with examples
Fix artifact naming inconsistency by clarifying that 00N-SYSTEM.md is a pattern notation where N represents sequential numbers (001, 002, etc.). Added concrete examples throughout to make it clear: - Line 32: Shows 001-SYSTEM.md with note about 002, etc. - Line 82: Explains pattern with (where N is a sequential number) - Line 104: Pattern with example (e.g., 001-SYSTEM.md) - Line 164: Pattern with multiple examples This resolves the confusion between pattern notation (00N) and concrete examples (001, 002). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent 9dbb526 commit 42115f4

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@
2929
/generate-context
3030
```
3131

32-
→ AI analyzes your codebase → Context document created in `docs/001-SYSTEM.md`
32+
→ AI analyzes your codebase → Context document created in `docs/001-SYSTEM.md` (or `002-SYSTEM.md`, etc.)
3333

3434
3. In your AI tool of choice, use `/generate-spec` with your idea:
3535

@@ -79,7 +79,7 @@ All prompts live in `prompts/` and are designed for use inside your preferred AI
7979
- Want to document technical decisions and design rationale
8080
- Setting up context for multiple specs in the same project
8181
82-
This prompt performs comprehensive codebase analysis and generates a `docs/00N-SYSTEM.md` file documenting architecture, tech stack, patterns, and conventions that inform all subsequent spec development.
82+
This prompt performs comprehensive codebase analysis and generates a `docs/00N-SYSTEM.md` file (where N is a sequential number: 001, 002, etc.) documenting architecture, tech stack, patterns, and conventions that inform all subsequent spec development.
8383
8484
### Core SDD Workflow
8585
@@ -101,7 +101,7 @@ Four prompts in `/prompts` define the full lifecycle. Use them sequentially to m
101101
102102
- **When to use:** Working with an existing codebase or starting multiple specs in the same project
103103
- **What it does:** Analyzes existing codebase architecture, extracts patterns and conventions, and documents technical decisions
104-
- **Output:** Creates `docs/00N-SYSTEM.md` with comprehensive codebase context that informs all subsequent spec generation
104+
- **Output:** Creates `docs/00N-SYSTEM.md` (e.g., `001-SYSTEM.md`) with comprehensive codebase context that informs all subsequent spec generation
105105
- **Skip when:** Starting a greenfield project or the AI already has sufficient context about your codebase
106106
107107
### Stage 1 — Generate the Spec ([prompts/generate-spec.md](./prompts/generate-spec.md))
@@ -161,7 +161,7 @@ sequenceDiagram
161161
162162
## Core Artifacts
163163
164-
- **Codebase Context (Optional):** `docs/00N-SYSTEM.md` — comprehensive codebase analysis documenting architecture, patterns, conventions, and technical decisions that inform spec development.
164+
- **Codebase Context (Optional):** `docs/00N-SYSTEM.md` (e.g., `001-SYSTEM.md`, `002-SYSTEM.md`) — comprehensive codebase analysis documenting architecture, patterns, conventions, and technical decisions that inform spec development.
165165
- **Specs:** `tasks/000X-spec-<feature>.md` — canonical requirements, demo slices, and success metrics.
166166
- **Task Lists:** `tasks/tasks-000X-spec-<feature>.md` — parent/subtask checklist with relevant files and proof artifacts.
167167
- **Status Keys:** `[ ]` not started, `[~]` in progress, `[x]` complete, mirroring the manage-tasks guidance.

0 commit comments

Comments
 (0)