@namewta/speculo 0.3.0 → 0.3.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.
Files changed (142) hide show
  1. package/README.md +1 -2
  2. package/package.json +3 -2
  3. package/template/canonical/README.md +7 -1
  4. package/template/canonical/canonical-specdev-engineering-cognitive-mentor.md +2040 -0
  5. package/template/canonical/canonical-specdev-goal-plan.md +1379 -0
  6. package/template/canonical/canonical-specdev-grill-with-docs.md +848 -285
  7. package/template/canonical/canonical-specdev-spec.md +1061 -46
  8. package/template/canonical/canonical-specdev-tickets.md +1529 -175
  9. package/template/canonical/canonical-specdev-wayfinder.md +677 -107
  10. package/template/commands/git-repository-audit.md +682 -0
  11. package/template/workflows/specdev/A-archive-and-consolidate/A-archive-and-consolidate.md +69 -36
  12. package/template/workflows/specdev/A-archive-and-consolidate/archive-checklist.md +15 -0
  13. package/template/workflows/specdev/A-archive-and-consolidate/knowledge-promotion-rules.md +32 -0
  14. package/template/workflows/specdev/D-diagnose-bugs/D-diagnose-bugs.md +51 -51
  15. package/template/workflows/specdev/D-diagnose-bugs/diagnosis-template.md +64 -0
  16. package/template/workflows/specdev/E-engineering-cognitive-mentor/E-engineering-cognitive-mentor.md +252 -0
  17. package/template/workflows/specdev/E-engineering-cognitive-mentor/architecture-guidance.md +90 -0
  18. package/template/workflows/specdev/E-engineering-cognitive-mentor/bug-guidance.md +80 -0
  19. package/template/workflows/specdev/E-engineering-cognitive-mentor/codebase-guidance.md +107 -0
  20. package/template/workflows/specdev/E-engineering-cognitive-mentor/comprehension-and-closure.md +95 -0
  21. package/template/workflows/specdev/E-engineering-cognitive-mentor/domain-learning-guidance.md +62 -0
  22. package/template/workflows/specdev/E-engineering-cognitive-mentor/evidence-and-options.md +132 -0
  23. package/template/workflows/specdev/E-engineering-cognitive-mentor/interaction-protocol.md +116 -0
  24. package/template/workflows/specdev/E-engineering-cognitive-mentor/mentor-report-template.md +135 -0
  25. package/template/workflows/specdev/E-engineering-cognitive-mentor/mode-routing.md +47 -0
  26. package/template/workflows/specdev/E-engineering-cognitive-mentor/persistence-and-resume.md +147 -0
  27. package/template/workflows/specdev/E-engineering-cognitive-mentor/requirements-guidance.md +92 -0
  28. package/template/workflows/specdev/G-grill-with-docs/G-grill-with-docs.md +100 -30
  29. package/template/workflows/specdev/G-grill-with-docs/adr-format.md +22 -77
  30. package/template/workflows/specdev/G-grill-with-docs/context-format.md +27 -53
  31. package/template/workflows/specdev/G-grill-with-docs/domain-modeling-rules.md +6 -82
  32. package/template/workflows/specdev/G-grill-with-docs/grilling-protocol.md +32 -49
  33. package/template/workflows/specdev/G-grill-with-docs/log-format.md +16 -98
  34. package/template/workflows/specdev/I-implement/I-implement.md +168 -52
  35. package/template/workflows/specdev/I-implement/code-review-process.md +10 -76
  36. package/template/workflows/specdev/I-implement/codebase-design-glossary.md +12 -109
  37. package/template/workflows/specdev/I-implement/deepening.md +12 -32
  38. package/template/workflows/specdev/I-implement/design-it-twice.md +6 -41
  39. package/template/workflows/specdev/I-implement/evidence-template.md +69 -0
  40. package/template/workflows/specdev/I-implement/execution-preflight.md +20 -0
  41. package/template/workflows/specdev/I-implement/tdd-examples.md +10 -135
  42. package/template/workflows/specdev/I-implement/tdd-rules.md +12 -28
  43. package/template/workflows/specdev/I-init-setup/I-init-setup.md +81 -86
  44. package/template/workflows/specdev/I-init-setup/change-status-template.json +15 -0
  45. package/template/workflows/specdev/I-init-setup/config-template.json +26 -0
  46. package/template/workflows/specdev/I-init-setup/domain-layout-template.md +23 -0
  47. package/template/workflows/specdev/I-init-setup/status-labels-template.md +55 -0
  48. package/template/workflows/specdev/I-init-setup/status-template.json +7 -0
  49. package/template/workflows/specdev/I-init-setup/tracking-template.md +10 -0
  50. package/template/workflows/specdev/INDEX.md +165 -82
  51. package/template/workflows/specdev/P-goal-plan/P-goal-plan.md +108 -44
  52. package/template/workflows/specdev/P-goal-plan/completion-control.md +79 -0
  53. package/template/workflows/specdev/P-goal-plan/goal-plan-template.md +105 -0
  54. package/template/workflows/specdev/P-goal-plan/orchestration-protocol.md +115 -0
  55. package/template/workflows/specdev/P-goal-plan/planning-modes.md +70 -0
  56. package/template/workflows/specdev/R-review-architecture/R-review-architecture.md +103 -40
  57. package/template/workflows/specdev/R-review-architecture/architecture-review-report-template.html +58 -0
  58. package/template/workflows/specdev/R-review-architecture/architecture-review-template.md +68 -0
  59. package/template/workflows/specdev/R-review-architecture/proposal-to-ticket.md +11 -0
  60. package/template/workflows/specdev/S-spec/S-spec.md +103 -49
  61. package/template/workflows/specdev/S-spec/spec-readiness.md +16 -0
  62. package/template/workflows/specdev/S-spec/spec-template.md +95 -0
  63. package/template/workflows/specdev/T-tickets/T-tickets.md +146 -133
  64. package/template/workflows/specdev/T-tickets/decomposition-rules.md +56 -0
  65. package/template/workflows/specdev/T-tickets/ticket-readiness.md +45 -0
  66. package/template/workflows/specdev/T-tickets/ticket-template.md +124 -0
  67. package/template/workflows/specdev/T-tickets/tickets-map-template.md +52 -50
  68. package/template/workflows/specdev/T-triage/T-triage.md +32 -63
  69. package/template/workflows/specdev/T-triage/triage-template.md +29 -0
  70. package/template/workflows/specdev/W-wayfinder/W-wayfinder.md +88 -155
  71. package/template/workflows/specdev/W-wayfinder/investigation-ticket-template.md +50 -0
  72. package/template/workflows/specdev/W-wayfinder/wayfinder-map-template.md +46 -0
  73. package/template/workflows/specdev/_state/status.json +1 -1
  74. package/template/workflows/specdev/common/README.md +47 -0
  75. package/template/workflows/specdev/common/rules/artifact-contract.md +57 -0
  76. package/template/workflows/specdev/common/rules/code-commenting-rule.md +39 -0
  77. package/template/workflows/specdev/common/rules/deviation-control.md +43 -0
  78. package/template/workflows/specdev/common/rules/evidence-and-verification.md +57 -0
  79. package/template/workflows/specdev/common/rules/path-ownership.md +35 -0
  80. package/template/workflows/specdev/common/rules/path-reference-contract.md +116 -0
  81. package/template/workflows/specdev/common/rules/planning-principles.md +57 -0
  82. package/template/workflows/specdev/common/rules/readiness-and-depth.md +51 -0
  83. package/template/workflows/specdev/common/schemas/change-status.schema.json +170 -0
  84. package/template/workflows/specdev/common/schemas/config.schema.json +54 -0
  85. package/template/workflows/specdev/common/schemas/goal-plan.schema.json +21 -0
  86. package/template/workflows/specdev/common/schemas/spec.schema.json +16 -0
  87. package/template/workflows/specdev/common/schemas/status.schema.json +149 -0
  88. package/template/workflows/specdev/common/schemas/ticket.schema.json +130 -0
  89. package/template/workflows/specdev/common/schemas/tickets-map.schema.json +14 -0
  90. package/template/workflows/specdev/common/skills/dev-worktree/SKILL.md +28 -0
  91. package/template/workflows/specdev/common/skills/dev-worktree/references/create.md +30 -0
  92. package/template/workflows/specdev/common/skills/dev-worktree/references/finalize.md +16 -0
  93. package/template/workflows/specdev/common/skills/research/SKILL.md +43 -0
  94. package/template/workflows/specdev/common/tools/README.md +16 -0
  95. package/template/workflows/specdev/common/tools/validate-specdev.mjs +1155 -0
  96. package/template/canonical/canonical-teach.md +0 -301
  97. package/template/workflows/specdev/A-archive-and-consolidate/archive-rules.md +0 -49
  98. package/template/workflows/specdev/A-archive-and-consolidate/cleanup-rules.md +0 -80
  99. package/template/workflows/specdev/A-archive-and-consolidate/consolidation-rules.md +0 -122
  100. package/template/workflows/specdev/A-archive-and-consolidate/discrimination-guide.md +0 -96
  101. package/template/workflows/specdev/A-archive-and-consolidate/knowledge-graduation.md +0 -51
  102. package/template/workflows/specdev/D-diagnose-bugs/cleanup-postmortem.md +0 -37
  103. package/template/workflows/specdev/D-diagnose-bugs/feedback-loop-techniques.md +0 -84
  104. package/template/workflows/specdev/D-diagnose-bugs/hypothesis-format.md +0 -46
  105. package/template/workflows/specdev/D-diagnose-bugs/instrumentation-rules.md +0 -51
  106. package/template/workflows/specdev/I-init-setup/domain-layout.md +0 -55
  107. package/template/workflows/specdev/I-init-setup/status-labels.md +0 -53
  108. package/template/workflows/specdev/I-init-setup/tracking-convention.md +0 -52
  109. package/template/workflows/specdev/P-goal-plan/execution-sections.md +0 -126
  110. package/template/workflows/specdev/P-goal-plan/governance-sections.md +0 -103
  111. package/template/workflows/specdev/P-goal-plan/input-validation.md +0 -94
  112. package/template/workflows/specdev/P-goal-plan/lead-orchestration-protocol.md +0 -158
  113. package/template/workflows/specdev/P-goal-plan/quick-reference-table.md +0 -60
  114. package/template/workflows/specdev/P-goal-plan/vision-sections.md +0 -80
  115. package/template/workflows/specdev/R-review-architecture/exploration-guide.md +0 -103
  116. package/template/workflows/specdev/R-review-architecture/html-report-template.md +0 -124
  117. package/template/workflows/specdev/T-triage/artifact-templates.md +0 -122
  118. package/template/workflows/specdev/T-triage/intake-rules.md +0 -71
  119. package/template/workflows/specdev/T-triage/routing-rules.md +0 -70
  120. package/template/workflows/specdev/T-triage/understanding-rules.md +0 -102
  121. package/template/workflows/specdev/_state/adr/.gitkeep +0 -0
  122. package/template/workflows/specdev/_state/context/.gitkeep +0 -0
  123. package/template/workflows/specdev/_state/research/.gitkeep +0 -0
  124. package/template/workflows/specdev/common/dev-worktree/SKILL.md +0 -48
  125. package/template/workflows/specdev/common/dev-worktree/references/create.md +0 -63
  126. package/template/workflows/specdev/common/dev-worktree/references/finalize.md +0 -102
  127. package/template/workflows/specdev/common/handoff/SKILL.md +0 -42
  128. package/template/workflows/specdev/common/neat-freak/SKILL.md +0 -210
  129. package/template/workflows/specdev/common/neat-freak/references/agent-paths.md +0 -72
  130. package/template/workflows/specdev/common/neat-freak/references/governance.md +0 -88
  131. package/template/workflows/specdev/common/neat-freak/references/sync-matrix.md +0 -77
  132. package/template/workflows/specdev/common/neat-freak/references/verification.md +0 -92
  133. package/template/workflows/specdev/common/neat-freak/scripts/audit-inventory.sh +0 -106
  134. package/template/workflows/specdev/common/prototype/LOGIC.md +0 -89
  135. package/template/workflows/specdev/common/prototype/SKILL.md +0 -78
  136. package/template/workflows/specdev/common/prototype/UI.md +0 -120
  137. package/template/workflows/specdev/common/research/SKILL.md +0 -54
  138. package/template/workflows/specdev/common/resolving-merge-conflicts/SKILL.md +0 -14
  139. package/template/workflows/specdev/common/scripts/hitl-loop.template.sh +0 -41
  140. package/template/workflows/specdev/common/triage/AGENT-BRIEF.md +0 -204
  141. package/template/workflows/specdev/common/triage/OUT-OF-SCOPE.md +0 -104
  142. package/template/workflows/specdev/common/triage/SKILL.md +0 -112
package/README.md CHANGED
@@ -73,8 +73,7 @@ Every workflow ships an `INDEX.md` as its auto-generated work catalog. Work entr
73
73
 
74
74
  - [AGENTS.md](./AGENTS.md) — AI agent handbook (authoritative)
75
75
  - [CHANGELOG.md](./CHANGELOG.md) — Release history
76
- - [docs/](./docs/) — Authoring contracts for commands, skills, workflows, and persistence
77
- - [.agents/skills/](./.agents/skills/) — Internal authoring tools for Speculo maintainers
76
+ - [.agents/skills/](./.agents/skills/) — Internal authoring tools for Speculo maintainers (self-contained authoring contracts under `_shared/` and per-skill `references/`)
78
77
  - [README-ZH.md](./README-ZH.md) — 中文镜像
79
78
 
80
79
  ## Acknowledgments — Honoring Open Source Heritage
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@namewta/speculo",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "Workflow-packaged specification-driven development assets with install, update, and migration tooling.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -10,7 +10,8 @@
10
10
  "build": "tsc -p tsconfig.json",
11
11
  "test": "node --test dist/test/*.test.js",
12
12
  "pretest": "pnpm build",
13
- "validate-assets": "node scripts/validate-framework-assets.mjs && node scripts/check-template-links.mjs",
13
+ "generate-canonical": "node scripts/generate-specdev-canonical.mjs",
14
+ "validate-assets": "node scripts/generate-specdev-canonical.mjs --check && node scripts/validate-framework-assets.mjs && node scripts/check-template-links.mjs",
14
15
  "check": "pnpm test && pnpm validate-assets",
15
16
  "verify-bin": "node scripts/verify-bin.mjs",
16
17
  "prepack": "pnpm build",
@@ -61,7 +61,13 @@ Canonical 文档是源文件的**透明容器**——去除 Speculo 内部元数
61
61
 
62
62
  ## 生成方法
63
63
 
64
- `speculo-write-canonical` skill 的流程手动拼接:
64
+ SpecDev 的设计、规格、Tickets、Goal Plan 和 Wayfinder canonical 使用 Node 脚本从当前模板统一生成:
65
+
66
+ ```bash
67
+ pnpm generate-canonical
68
+ ```
69
+
70
+ 其他 canonical 按 `speculo-write-canonical` skill 的流程手动拼接:
65
71
 
66
72
  1. 读取能力源目录,识别主入口和所有被引用文件
67
73
  2. 去除所有 YAML frontmatter