sdd-flow 1.3.3 → 2.0.1
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/CHANGELOG.md +39 -0
- package/CONTRIBUTING.md +25 -0
- package/LICENSE +21 -21
- package/README.md +402 -168
- package/README.pt-BR.md +387 -0
- package/bin/cli.js +162 -424
- package/docs/architecture.md +91 -0
- package/docs/distribution.md +64 -0
- package/docs/formats.md +215 -0
- package/docs/local-testing.pt-BR.md +196 -0
- package/docs/methodology.pt-BR.md +139 -0
- package/docs/migration.md +76 -0
- package/docs/quality-gates.pt-BR.md +160 -0
- package/docs/quality.md +56 -0
- package/docs/releases.pt-BR.md +105 -0
- package/docs/setup-documents.pt-BR.md +120 -0
- package/docs/usage.pt-BR.md +310 -0
- package/docs/validation.md +101 -0
- package/lib/adapters.js +115 -0
- package/lib/check.js +221 -0
- package/lib/context.js +117 -0
- package/lib/documents.js +71 -0
- package/lib/handoff.js +81 -0
- package/lib/history.js +16 -0
- package/lib/install.js +181 -0
- package/lib/io.js +119 -0
- package/lib/legacy-hashes.json +31 -0
- package/lib/markdown.js +71 -0
- package/lib/project.js +200 -0
- package/lib/quality.js +24 -0
- package/lib/revisions.js +79 -0
- package/lib/verification.js +267 -0
- package/package.json +55 -32
- package/templates/AGENTS.md +12 -50
- package/templates/QUICKSTART.md +16 -70
- package/templates/agents/AGENTS.md +58 -92
- package/templates/agents/DECISIONS.md +5 -21
- package/templates/agents/POLICIES.md +14 -0
- package/templates/agents/PROJECT.md +35 -145
- package/templates/agents/QUALITY.md +19 -0
- package/templates/agents/RULES.md +24 -132
- package/templates/agents/SETUP.md +38 -224
- package/templates/agents/config.yaml +13 -0
- package/templates/agents/current/_template.md +19 -0
- package/templates/agents/decisions/_template.md +22 -0
- package/templates/agents/prompts/conventional-commit.md +11 -51
- package/templates/agents/prompts/intake.md +23 -0
- package/templates/agents/prompts/pr-template.md +12 -21
- package/templates/agents/prompts/quality.md +57 -0
- package/templates/agents/prompts/rpi-close.md +23 -0
- package/templates/agents/prompts/rpi-implement.md +35 -68
- package/templates/agents/prompts/rpi-plan.md +87 -117
- package/templates/agents/prompts/rpi-research.md +21 -67
- package/templates/agents/prompts/rpi-validate.md +40 -103
- package/templates/agents/prompts/skill-call.md +11 -29
- package/templates/agents/prompts/task-create.md +13 -42
- package/templates/agents/skills/_template/SKILL.md +11 -37
- package/templates/agents/harness/claude-code/.hooks/guard-delete.sh +0 -22
- package/templates/agents/harness/claude-code/.hooks/guard-deps.sh +0 -25
- package/templates/agents/harness/claude-code/.hooks/guard-git.sh +0 -24
- package/templates/agents/harness/claude-code/commands/sdd-implement.md +0 -3
- package/templates/agents/harness/claude-code/commands/sdd-plan.md +0 -3
- package/templates/agents/harness/claude-code/commands/sdd-research.md +0 -3
- package/templates/agents/harness/claude-code/commands/sdd-validate.md +0 -3
- package/templates/agents/harness/claude-code/settings.json +0 -34
- package/templates/agents/harness/opencode/commands/sdd-implement.md +0 -3
- package/templates/agents/harness/opencode/commands/sdd-plan.md +0 -3
- package/templates/agents/harness/opencode/commands/sdd-research.md +0 -3
- package/templates/agents/harness/opencode/commands/sdd-validate.md +0 -3
- package/templates/agents/harness/opencode/opencode.json +0 -18
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 2.0.1 — 2026-11-20
|
|
4
|
+
|
|
5
|
+
- Default new projects to step; follow explicit multi-task/all-task authorization as a bounded batch without resetting existing project preferences.
|
|
6
|
+
- Redesign README and update usage, migration, format and validation documentation accordingly.
|
|
7
|
+
- Add default engineering rules: KISS/Clean Code/YAGNI/DRY/SOLID guidance and no redundant comments or docblocks.
|
|
8
|
+
|
|
9
|
+
## 2.0.0 — 2026-11-20
|
|
10
|
+
|
|
11
|
+
Breaking: Node.js 22+, schema 2 artifacts, canonical YAML task state and version-bound scope/evidence.
|
|
12
|
+
|
|
13
|
+
- Replace fixed-line skill scanning with real YAML metadata and a discovery catalog.
|
|
14
|
+
- Add light/standard/rigorous modes and configurable step/batch autonomy.
|
|
15
|
+
- Add context, check, approve, evidence, verify, close, reopen, cancel, status, doctor and migration commands.
|
|
16
|
+
- Preserve existing entry-point content and customized files; add dry-run, ownership tracking and backups.
|
|
17
|
+
- Support manual/inspection evidence, partial verification and stale-input detection.
|
|
18
|
+
- Consolidate current knowledge before archival; reserve IDs beyond 999 and across archives.
|
|
19
|
+
- Install active Claude Code/OpenCode entry points and export versioned knowledge bundles.
|
|
20
|
+
- Retire distributed regex/TTY shell hooks; preserve old project settings for explicit migration review.
|
|
21
|
+
- Add automated regression tests, package checks and CI.
|
|
22
|
+
- Add body-free context inspection, section-scoped requirement sources and broad-request intake guidance.
|
|
23
|
+
- Preserve mandatory project policies, approved scope snapshots, revision impact and individual run receipts.
|
|
24
|
+
- Prepare manual OIDC npm publishing with next-first distribution, release identity checks and usage/release guides.
|
|
25
|
+
- Clarify the methodology's harness-independent scope and optional session boundaries, without adding an orchestrator.
|
|
26
|
+
- Carry a configurable project documentation language in context, preserve UTF-8/diacritics and seed Portuguese artifacts.
|
|
27
|
+
- Preserve completed setup on reinitialization with accurate maintenance guidance; add PowerShell testing/release instructions.
|
|
28
|
+
- Add required/advisory quality gates, opt-in external checks and project-owned quality policy.
|
|
29
|
+
- Record version-bound environment handoffs and safe user-test guides; allow implementation closure with explicit limitations.
|
|
30
|
+
- Preserve known observed failures, deferred verification tasks and later real verification without erasing history.
|
|
31
|
+
- Strengthen optional BDD/TDD guidance while keeping detailed quality procedures outside default implementation context.
|
|
32
|
+
- Make PRD/ADR/design inputs optional, strengthen existing-project baseline adoption and scoped consumer-regression analysis.
|
|
33
|
+
- Make the offline installed-package smoke test independent of warmed npm registry metadata caches.
|
|
34
|
+
- Restore opt-in legacy reference drafts with init --docs and add selected PRD, system design, design system, ADR and roadmap presets.
|
|
35
|
+
- Preserve existing reference files, preflight document collisions and distinguish proposed ADR templates from actual active decisions.
|
|
36
|
+
|
|
37
|
+
## 1.3.3
|
|
38
|
+
|
|
39
|
+
Previous public baseline, analyzed at commit d84c62d51d9c566b0f3e8a6279418220e0fc6e8f.
|
package/CONTRIBUTING.md
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# Contributing
|
|
2
|
+
|
|
3
|
+
## Development
|
|
4
|
+
|
|
5
|
+
~~~sh
|
|
6
|
+
git clone https://github.com/moisesuailab/sdd-flow.git
|
|
7
|
+
cd sdd-flow
|
|
8
|
+
npm ci
|
|
9
|
+
npm test
|
|
10
|
+
npm run check
|
|
11
|
+
~~~
|
|
12
|
+
|
|
13
|
+
Use Node.js 22+. The CLI uses CommonJS and the maintained yaml parser.
|
|
14
|
+
Runtime modules live in lib/, the entry point in bin/, canonical knowledge in templates/agents/,
|
|
15
|
+
and behavior/integration tests in test/. This repository owns both the CLI and templates.
|
|
16
|
+
|
|
17
|
+
## Changes
|
|
18
|
+
|
|
19
|
+
Describe the concrete problem and resulting behavior. Keep procedures concise and avoid
|
|
20
|
+
duplicating schema contracts across utility prompts. Add meaningful regression tests for
|
|
21
|
+
lifecycle, preservation, verification or compatibility changes.
|
|
22
|
+
Run the package smoke test and check that npm includes all runtime files.
|
|
23
|
+
|
|
24
|
+
Do not edit personal/global tool settings when testing adapters.
|
|
25
|
+
Use temporary projects. Do not publish npm or marketplace artifacts as part of tests.
|
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 moisesuailab
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 moisesuailab
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|