You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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]>
Copy file name to clipboardExpand all lines: README.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,7 +29,7 @@
29
29
/generate-context
30
30
```
31
31
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.)
33
33
34
34
3. In your AI tool of choice, use `/generate-spec` with your idea:
35
35
@@ -79,7 +79,7 @@ All prompts live in `prompts/` and are designed for use inside your preferred AI
79
79
- Want to document technical decisions and design rationale
80
80
- Setting up context for multiple specs in the same project
81
81
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.
83
83
84
84
### Core SDD Workflow
85
85
@@ -101,7 +101,7 @@ Four prompts in `/prompts` define the full lifecycle. Use them sequentially to m
101
101
102
102
- **When to use:** Working with an existing codebase or starting multiple specs in the same project
103
103
- **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
105
105
- **Skip when:** Starting a greenfield project or the AI already has sufficient context about your codebase
106
106
107
107
### Stage 1 — Generate the Spec ([prompts/generate-spec.md](./prompts/generate-spec.md))
@@ -161,7 +161,7 @@ sequenceDiagram
161
161
162
162
## Core Artifacts
163
163
164
-
- **Codebase Context (Optional):** `docs/00N-SYSTEM.md` — comprehensive codebase analysis documenting architecture, patterns, conventions, and technical decisions that inform spec development.
0 commit comments