specsmd 0.0.0-dev.30 → 0.0.0-dev.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -79,12 +79,11 @@ Or ask: "What's the next task for user-auth?"
79
79
  ## Output Structure
80
80
 
81
81
  ```
82
- memory-bank/
83
- └── specs/
84
- └── {feature-name}/
85
- ├── requirements.md # Phase 1: What to build
86
- ├── design.md # Phase 2: How to build it
87
- └── tasks.md # Phase 3: Step-by-step plan
82
+ specs/
83
+ └── {feature-name}/
84
+ ├── requirements.md # Phase 1: What to build
85
+ ├── design.md # Phase 2: How to build it
86
+ └── tasks.md # Phase 3: Step-by-step plan
88
87
  ```
89
88
 
90
89
  ## EARS Format
@@ -141,7 +140,7 @@ src/flows/simple/
141
140
  | **Target** | Quick feature specs | Full development lifecycle |
142
141
  | **Phases** | 3: Requirements → Design → Tasks | 3: Inception → Construction → Operations |
143
142
  | **Agents** | 1 (Agent) | 4 (Master, Inception, Construction, Operations) |
144
- | **Output** | 3 markdown files | Full memory-bank hierarchy |
143
+ | **Output** | 3 markdown files | Full artifact hierarchy |
145
144
  | **DDD Stages** | Not included | Full DDD stages in Construction |
146
145
  | **Bolts** | No concept | Time-boxed execution sessions |
147
146
  | **Hierarchy** | Flat (specs/) | Nested (intents/units/stories) |
@@ -119,14 +119,6 @@ On activation, read:
119
119
  specs/ # Existing specs (for state detection)
120
120
  ```
121
121
 
122
- ## Available Tools
123
-
124
- Check for the `AskUserQuestionTool` tool:
125
- - **If available** (Claude Code): Use it for clarifying questions (provides structured input)
126
- - **If not available**: Ask directly in your response text
127
-
128
- The agent should work in any environment - fall back gracefully if tools are unavailable.
129
-
130
122
  ## State Detection
131
123
 
132
124
  Check `specs/{feature-name}/` to determine state:
@@ -16,7 +16,7 @@ When this command is invoked, the agent should:
16
16
  1. **Load Context**
17
17
  - Read `.specsmd/simple/memory-bank.yaml`
18
18
  - Read `.specsmd/simple/agents/agent.md`
19
- - Scan `memory-bank/specs/` for existing specs
19
+ - Scan `specs/` for existing specs
20
20
 
21
21
  2. **Parse Arguments**
22
22
  - `$ARGUMENTS` contains user input after command
@@ -16,19 +16,19 @@ context:
16
16
  design:
17
17
  - path: ".specsmd/simple/skills/design.md"
18
18
  - path: ".specsmd/simple/templates/design-template.md"
19
- - path: "memory-bank/specs/{feature}/requirements.md"
19
+ - path: "specs/{feature}/requirements.md"
20
20
  tasks:
21
21
  - path: ".specsmd/simple/skills/tasks.md"
22
22
  - path: ".specsmd/simple/templates/tasks-template.md"
23
- - path: "memory-bank/specs/{feature}/requirements.md"
24
- - path: "memory-bank/specs/{feature}/design.md"
23
+ - path: "specs/{feature}/requirements.md"
24
+ - path: "specs/{feature}/design.md"
25
25
  execute:
26
26
  - path: ".specsmd/simple/skills/execute.md"
27
- - path: "memory-bank/specs/{feature}/requirements.md"
28
- - path: "memory-bank/specs/{feature}/design.md"
29
- - path: "memory-bank/specs/{feature}/tasks.md"
27
+ - path: "specs/{feature}/requirements.md"
28
+ - path: "specs/{feature}/design.md"
29
+ - path: "specs/{feature}/tasks.md"
30
30
 
31
31
  # Scan directories on activation
32
32
  scan:
33
- - path: "memory-bank/specs/"
33
+ - path: "specs/"
34
34
  purpose: "Detect existing specs for state detection"
@@ -27,10 +27,10 @@ naming:
27
27
 
28
28
  # Schema Definition (Source of Truth for Agent)
29
29
  schema:
30
- specs: "memory-bank/specs/{feature-name}/"
31
- requirements: "memory-bank/specs/{feature-name}/requirements.md"
32
- design: "memory-bank/specs/{feature-name}/design.md"
33
- tasks: "memory-bank/specs/{feature-name}/tasks.md"
30
+ specs: "specs/{feature-name}/"
31
+ requirements: "specs/{feature-name}/requirements.md"
32
+ design: "specs/{feature-name}/design.md"
33
+ tasks: "specs/{feature-name}/tasks.md"
34
34
 
35
35
  # Workflow Configuration
36
36
  workflow:
@@ -126,12 +126,11 @@ After creating specs, your project will have:
126
126
  ├── memory-bank.yaml # Storage schema
127
127
  └── quick-start.md # This file
128
128
 
129
- memory-bank/
130
- └── specs/ # Your feature specs
131
- └── {feature-name}/
132
- ├── requirements.md # What to build
133
- ├── design.md # How to build it
134
- └── tasks.md # Step-by-step plan
129
+ specs/ # Your feature specs
130
+ └── {feature-name}/
131
+ ├── requirements.md # What to build
132
+ ├── design.md # How to build it
133
+ └── tasks.md # Step-by-step plan
135
134
  ```
136
135
 
137
136
  ---
@@ -190,7 +189,7 @@ The agent is stateless. It reads spec files at startup. Ensure documents are sav
190
189
  When you run `/specsmd-agent` without arguments, it lists existing specs and asks which to work on.
191
190
 
192
191
  ### Want to start over
193
- Delete the spec folder: `rm -rf memory-bank/specs/{feature-name}`
192
+ Delete the spec folder: `rm -rf specs/{feature-name}`
194
193
 
195
194
  ### Get help
196
195
  Ask the agent: `/specsmd-agent How do I add a new requirement?`
@@ -19,10 +19,10 @@ Generate a technical design document based on approved requirements. This is Pha
19
19
 
20
20
  ### Initial Generation
21
21
 
22
- 1. **Read requirements** from `memory-bank/specs/{feature}/requirements.md`
22
+ 1. **Read requirements** from `specs/{feature}/requirements.md`
23
23
  2. **Research codebase** if needed:
24
24
  - Identify existing patterns and conventions
25
- - Check tech stack from `memory-bank/standards/` if available
25
+ - Check existing project standards if available
26
26
  - Look for similar implementations to reference
27
27
  3. **Generate design.md** following the template:
28
28
  - Overview (solution approach, tech decisions)
@@ -31,7 +31,7 @@ Generate a technical design document based on approved requirements. This is Pha
31
31
  - Data Models (with validation rules)
32
32
  - Error Handling (recovery strategies)
33
33
  - Testing Strategy
34
- 4. **Write file** to `memory-bank/specs/{feature}/design.md`
34
+ 4. **Write file** to `specs/{feature}/design.md`
35
35
  5. **Ask for approval**: "Does the design look good? If so, we can move on to the implementation plan."
36
36
 
37
37
  ### Update Flow
@@ -65,7 +65,7 @@ Generate a technical design document based on approved requirements. This is Pha
65
65
 
66
66
  ## Output
67
67
 
68
- - **File**: `memory-bank/specs/{feature-name}/design.md`
68
+ - **File**: `specs/{feature-name}/design.md`
69
69
  - **Approval Prompt**: "Does the design look good? If so, we can move on to the implementation plan."
70
70
 
71
71
  ## Design Sections Checklist
@@ -7,9 +7,9 @@ Execute implementation tasks from an approved tasks.md file. This is the post-sp
7
7
  ## Preconditions
8
8
 
9
9
  - All three spec files exist:
10
- - `memory-bank/specs/{feature}/requirements.md`
11
- - `memory-bank/specs/{feature}/design.md`
12
- - `memory-bank/specs/{feature}/tasks.md`
10
+ - `specs/{feature}/requirements.md`
11
+ - `specs/{feature}/design.md`
12
+ - `specs/{feature}/tasks.md`
13
13
  - Tasks have been approved by user
14
14
 
15
15
  ## Trigger Conditions
@@ -16,12 +16,12 @@ Generate a requirements document for a feature using EARS (Easy Approach to Requ
16
16
 
17
17
  1. **Parse feature idea** from user input
18
18
  2. **Derive feature name** in kebab-case (e.g., "user-authentication")
19
- 3. **Create directory** at `memory-bank/specs/{feature-name}/`
19
+ 3. **Create directory** at `specs/{feature-name}/`
20
20
  4. **Generate requirements.md** following the template:
21
21
  - Introduction (2-3 sentences)
22
22
  - Glossary (3-10 domain terms)
23
23
  - Requirements (3-7 user stories with EARS acceptance criteria)
24
- 5. **Write file** to `memory-bank/specs/{feature-name}/requirements.md`
24
+ 5. **Write file** to `specs/{feature-name}/requirements.md`
25
25
  6. **Ask for approval**: "Do the requirements look good? If so, we can move on to the design."
26
26
 
27
27
  ### Update Flow (Existing Spec)
@@ -53,7 +53,7 @@ Generate a requirements document for a feature using EARS (Easy Approach to Requ
53
53
 
54
54
  ## Output
55
55
 
56
- - **File**: `memory-bank/specs/{feature-name}/requirements.md`
56
+ - **File**: `specs/{feature-name}/requirements.md`
57
57
  - **Approval Prompt**: "Do the requirements look good? If so, we can move on to the design."
58
58
 
59
59
  ## Example Generation
@@ -20,8 +20,8 @@ Generate an implementation plan with coding tasks based on the approved design.
20
20
  ### Initial Generation
21
21
 
22
22
  1. **Read both documents**:
23
- - `memory-bank/specs/{feature}/requirements.md`
24
- - `memory-bank/specs/{feature}/design.md`
23
+ - `specs/{feature}/requirements.md`
24
+ - `specs/{feature}/design.md`
25
25
  2. **Convert design into tasks**:
26
26
  - Create incremental coding steps
27
27
  - Each task builds on previous
@@ -31,7 +31,7 @@ Generate an implementation plan with coding tasks based on the approved design.
31
31
  - Numbered checkbox list
32
32
  - Max 2 levels of hierarchy
33
33
  - Requirement references for traceability
34
- 4. **Write file** to `memory-bank/specs/{feature}/tasks.md`
34
+ 4. **Write file** to `specs/{feature}/tasks.md`
35
35
  5. **Ask for approval**: "Do the tasks look good?"
36
36
 
37
37
  ### Update Flow
@@ -82,7 +82,7 @@ Generate an implementation plan with coding tasks based on the approved design.
82
82
 
83
83
  ## Output
84
84
 
85
- - **File**: `memory-bank/specs/{feature-name}/tasks.md`
85
+ - **File**: `specs/{feature-name}/tasks.md`
86
86
  - **Approval Prompt**: "Do the tasks look good?"
87
87
 
88
88
  ## Task Types (Include)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "specsmd",
3
- "version": "0.0.0-dev.30",
3
+ "version": "0.0.0-dev.32",
4
4
  "description": "Multi-agent orchestration system for AI-native software development. Delivers AI-DLC, Agile, and custom SDLC flows as markdown-based agent systems.",
5
5
  "main": "lib/installer.js",
6
6
  "bin": {