sdd-flow 1.0.0 → 1.2.4
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.
- package/README.md +83 -83
- package/bin/cli.js +380 -315
- package/package.json +32 -32
- package/templates/QUICKSTART.md +50 -50
- package/templates/agents/AGENTS.md +92 -92
- package/templates/agents/RULES.md +116 -116
- package/templates/agents/harness/claude-code/.hooks/guard-delete.sh +21 -21
- package/templates/agents/harness/claude-code/.hooks/guard-deps.sh +24 -24
- package/templates/agents/harness/claude-code/.hooks/guard-git.sh +23 -23
- package/templates/agents/harness/claude-code/commands/sdd-implement.md +3 -3
- package/templates/agents/harness/claude-code/commands/sdd-plan.md +3 -3
- package/templates/agents/harness/claude-code/commands/sdd-research.md +3 -3
- package/templates/agents/harness/claude-code/commands/sdd-validate.md +3 -3
- package/templates/agents/harness/opencode/commands/sdd-implement.md +3 -3
- package/templates/agents/harness/opencode/commands/sdd-plan.md +3 -3
- package/templates/agents/harness/opencode/commands/sdd-research.md +3 -3
- package/templates/agents/harness/opencode/commands/sdd-validate.md +3 -3
- package/templates/agents/prompts/rpi-implement.md +46 -46
- package/templates/agents/prompts/rpi-plan.md +117 -117
- package/templates/agents/prompts/rpi-validate.md +96 -96
package/README.md
CHANGED
|
@@ -1,83 +1,83 @@
|
|
|
1
|
-
# sdd-flow
|
|
2
|
-
|
|
3
|
-
Spec Driven Development workflow for AI-assisted development.
|
|
4
|
-
|
|
5
|
-
Installs a structured **Research → Plan → Implement → Validate** cycle into any project, powered by markdown artifacts and isolated agent sessions.
|
|
6
|
-
|
|
7
|
-
Works with Claude Code, OpenCode, Cursor, Codex CLI, and any agentic IDE with filesystem access.
|
|
8
|
-
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
## Install
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
npm install -g sdd-flow
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
---
|
|
18
|
-
|
|
19
|
-
## Usage
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
sdd init # Instala o workflow no projeto atual
|
|
23
|
-
sdd harness # Instala, troca ou remove o harness do agente
|
|
24
|
-
sdd update # Atualiza prompts e regras, preserva dados do projeto
|
|
25
|
-
sdd --version
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
> Alias disponível: use `sdd` ou `sdd-cli` — ambos funcionam.
|
|
29
|
-
|
|
30
|
-
### New or existing project
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
cd my-project
|
|
34
|
-
sdd init
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
Installs the `agents/` folder with all workflow files. Optionally installs safety hooks and slash commands for your agent (Claude Code or OpenCode).
|
|
38
|
-
|
|
39
|
-
### Add or switch harness after init
|
|
40
|
-
|
|
41
|
-
```bash
|
|
42
|
-
sdd harness
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
Installs, replaces, or removes the harness and slash commands at any time — no need to reinstall the package.
|
|
46
|
-
|
|
47
|
-
### Update workflow (preserves your project data)
|
|
48
|
-
|
|
49
|
-
```bash
|
|
50
|
-
sdd update
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
Updates `AGENTS.md`, `RULES.md`, `QUICKSTART.md`, and all prompts. Your `PROJECT.md`, `DECISIONS.md`, `skills/`, `specs/`, and `harness/` are never touched.
|
|
54
|
-
|
|
55
|
-
---
|
|
56
|
-
|
|
57
|
-
## After `init`
|
|
58
|
-
|
|
59
|
-
1. Open a new session with your agent
|
|
60
|
-
2. Instruct: *"Read and follow `agents/SETUP.md`"*
|
|
61
|
-
3. Provide your PRD or describe the project
|
|
62
|
-
4. Review the generated files and delete `agents/SETUP.md`
|
|
63
|
-
|
|
64
|
-
---
|
|
65
|
-
|
|
66
|
-
## The RPI Cycle
|
|
67
|
-
|
|
68
|
-
Each feature goes through four isolated phases, each in its own agent session:
|
|
69
|
-
|
|
70
|
-
| Phase | Slash command | Prompt file |
|
|
71
|
-
|---|---|---|
|
|
72
|
-
| Research | `/sdd-research 001-feature` | `agents/prompts/rpi-research.md` |
|
|
73
|
-
| Plan | `/sdd-plan 001-feature` | `agents/prompts/rpi-plan.md` |
|
|
74
|
-
| Implement | `/sdd-implement 001-feature` | `agents/prompts/rpi-implement.md` |
|
|
75
|
-
| Validate | `/sdd-validate 001-feature` | `agents/prompts/rpi-validate.md` |
|
|
76
|
-
|
|
77
|
-
> Slash commands require harness installation (`sdd harness`).
|
|
78
|
-
|
|
79
|
-
---
|
|
80
|
-
|
|
81
|
-
## Source
|
|
82
|
-
|
|
83
|
-
[github.com/moisesuailab/spec-driven-workflow](https://github.com/moisesuailab/spec-driven-workflow)
|
|
1
|
+
# sdd-flow
|
|
2
|
+
|
|
3
|
+
Spec Driven Development workflow for AI-assisted development.
|
|
4
|
+
|
|
5
|
+
Installs a structured **Research → Plan → Implement → Validate** cycle into any project, powered by markdown artifacts and isolated agent sessions.
|
|
6
|
+
|
|
7
|
+
Works with Claude Code, OpenCode, Cursor, Codex CLI, and any agentic IDE with filesystem access.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## Install
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
npm install -g sdd-flow
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## Usage
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
sdd init # Instala o workflow no projeto atual
|
|
23
|
+
sdd harness # Instala, troca ou remove o harness do agente
|
|
24
|
+
sdd update # Atualiza prompts e regras, preserva dados do projeto
|
|
25
|
+
sdd --version
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
> Alias disponível: use `sdd` ou `sdd-cli` — ambos funcionam.
|
|
29
|
+
|
|
30
|
+
### New or existing project
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
cd my-project
|
|
34
|
+
sdd init
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Installs the `agents/` folder with all workflow files. Optionally installs safety hooks and slash commands for your agent (Claude Code or OpenCode).
|
|
38
|
+
|
|
39
|
+
### Add or switch harness after init
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
sdd harness
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Installs, replaces, or removes the harness and slash commands at any time — no need to reinstall the package.
|
|
46
|
+
|
|
47
|
+
### Update workflow (preserves your project data)
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
sdd update
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
Updates `AGENTS.md`, `RULES.md`, `QUICKSTART.md`, and all prompts. Your `PROJECT.md`, `DECISIONS.md`, `skills/`, `specs/`, and `harness/` are never touched.
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## After `init`
|
|
58
|
+
|
|
59
|
+
1. Open a new session with your agent
|
|
60
|
+
2. Instruct: *"Read and follow `agents/SETUP.md`"*
|
|
61
|
+
3. Provide your PRD or describe the project
|
|
62
|
+
4. Review the generated files and delete `agents/SETUP.md`
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## The RPI Cycle
|
|
67
|
+
|
|
68
|
+
Each feature goes through four isolated phases, each in its own agent session:
|
|
69
|
+
|
|
70
|
+
| Phase | Slash command | Prompt file |
|
|
71
|
+
|---|---|---|
|
|
72
|
+
| Research | `/sdd-research 001-feature` | `agents/prompts/rpi-research.md` |
|
|
73
|
+
| Plan | `/sdd-plan 001-feature` | `agents/prompts/rpi-plan.md` |
|
|
74
|
+
| Implement | `/sdd-implement 001-feature` | `agents/prompts/rpi-implement.md` |
|
|
75
|
+
| Validate | `/sdd-validate 001-feature` | `agents/prompts/rpi-validate.md` |
|
|
76
|
+
|
|
77
|
+
> Slash commands require harness installation (`sdd harness`).
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
## Source
|
|
82
|
+
|
|
83
|
+
[github.com/moisesuailab/spec-driven-workflow](https://github.com/moisesuailab/spec-driven-workflow)
|