@namewta/speculo 0.4.0 → 0.5.0

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 (62) hide show
  1. package/README.md +3 -4
  2. package/package.json +1 -1
  3. package/template/canonical/canonical-specdev-engineering-cognitive-mentor.md +5 -0
  4. package/template/canonical/canonical-specdev-goal-plan.md +366 -59
  5. package/template/canonical/canonical-specdev-grill-with-docs.md +153 -104
  6. package/template/canonical/canonical-specdev-spec.md +5 -0
  7. package/template/canonical/canonical-specdev-tickets.md +5 -0
  8. package/template/canonical/canonical-specdev-wayfinder.md +171 -249
  9. package/template/commands/docs-sync.md +3 -3
  10. package/template/skills/docs-sync/SKILL.md +4 -3
  11. package/template/skills/docs-sync/assets/report-template.md +1 -0
  12. package/template/skills/docs-sync/references/agents/agent-writing.md +75 -0
  13. package/template/skills/{agents-md-builder/references → docs-sync/references/agents}/claude-redirect.md +1 -1
  14. package/template/skills/docs-sync/references/agents-contract.md +23 -1
  15. package/template/workflows/specdev/G-grill-with-docs/G-grill-with-docs.md +78 -73
  16. package/template/workflows/specdev/G-grill-with-docs/design-tree-template.json +9 -0
  17. package/template/workflows/specdev/G-grill-with-docs/grilling-protocol.md +16 -35
  18. package/template/workflows/specdev/G-grill-with-docs/log-format.md +2 -0
  19. package/template/workflows/specdev/I-implement/I-implement.md +12 -10
  20. package/template/workflows/specdev/I-implement/design-it-twice.md +45 -6
  21. package/template/workflows/specdev/I-implement/evidence-template.md +7 -0
  22. package/template/workflows/specdev/I-implement/execution-preflight.md +6 -0
  23. package/template/workflows/specdev/INDEX.md +11 -4
  24. package/template/workflows/specdev/P-goal-plan/P-goal-plan.md +23 -10
  25. package/template/workflows/specdev/P-goal-plan/completion-control.md +20 -7
  26. package/template/workflows/specdev/P-goal-plan/goal-plan-template.md +55 -3
  27. package/template/workflows/specdev/P-goal-plan/orchestration-protocol.md +42 -38
  28. package/template/workflows/specdev/P-goal-plan/planning-modes.md +36 -2
  29. package/template/workflows/specdev/R-review-architecture/R-review-architecture.md +67 -80
  30. package/template/workflows/specdev/R-review-architecture/architecture-report-contract.md +123 -0
  31. package/template/workflows/specdev/R-review-architecture/architecture-review-report-template.html +103 -55
  32. package/template/workflows/specdev/R-review-architecture/architecture-review-template.md +20 -29
  33. package/template/workflows/specdev/W-wayfinder/W-wayfinder.md +76 -147
  34. package/template/workflows/specdev/W-wayfinder/investigation-ticket-template.md +8 -53
  35. package/template/workflows/specdev/W-wayfinder/local-tracker-contract.md +36 -0
  36. package/template/workflows/specdev/W-wayfinder/solution-comment-template.md +17 -0
  37. package/template/workflows/specdev/W-wayfinder/wayfinder-map-template.md +12 -65
  38. package/template/workflows/specdev/common/README.md +4 -0
  39. package/template/workflows/specdev/common/rules/artifact-contract.md +5 -0
  40. package/template/workflows/specdev/common/rules/codebase-design.md +148 -0
  41. package/template/workflows/specdev/common/schemas/design-tree.schema.json +35 -0
  42. package/template/workflows/specdev/common/schemas/wayfinder-ticket.schema.json +19 -0
  43. package/template/workflows/specdev/common/skills/subagent-delivery/SKILL.md +61 -0
  44. package/template/workflows/specdev/common/skills/subagent-delivery/references/external-web-subagent.md +32 -0
  45. package/template/workflows/specdev/common/skills/subagent-delivery/references/github-checkpoints.md +24 -0
  46. package/template/workflows/specdev/common/skills/subagent-delivery/references/native-subagent.md +35 -0
  47. package/template/workflows/specdev/common/skills/subagent-delivery/references/source-package.md +17 -0
  48. package/template/workflows/specdev/common/tools/validate-specdev.mjs +226 -5
  49. package/template/skills/agents-md-builder/SKILL.md +0 -30
  50. package/template/workflows/specdev/I-implement/codebase-design-glossary.md +0 -12
  51. package/template/workflows/specdev/I-implement/deepening.md +0 -17
  52. /package/template/skills/{agents-md-builder/references → docs-sync/references/agents}/content-contract.md +0 -0
  53. /package/template/skills/{agents-md-builder/references → docs-sync/references/agents}/evidence-collection.md +0 -0
  54. /package/template/skills/{agents-md-builder/references → docs-sync/references/agents}/manifest-discovery.md +0 -0
  55. /package/template/skills/{agents-md-builder/references → docs-sync/references/agents}/role-classification.md +0 -0
  56. /package/template/skills/{agents-md-builder/references → docs-sync/references/agents}/templates/aggregator-AGENTS.md +0 -0
  57. /package/template/skills/{agents-md-builder/references → docs-sync/references/agents}/templates/capability-module-AGENTS.md +0 -0
  58. /package/template/skills/{agents-md-builder/references → docs-sync/references/agents}/templates/contract-module-AGENTS.md +0 -0
  59. /package/template/skills/{agents-md-builder/references → docs-sync/references/agents}/templates/repo-root-AGENTS.md +0 -0
  60. /package/template/skills/{agents-md-builder/references → docs-sync/references/agents}/templates/runnable-app-AGENTS.md +0 -0
  61. /package/template/skills/{agents-md-builder/references → docs-sync/references/agents}/templates/scripts-docs-AGENTS.md +0 -0
  62. /package/template/skills/{agents-md-builder/references → docs-sync/references/agents}/writing-style.md +0 -0
package/README.md CHANGED
@@ -44,18 +44,17 @@ After initialization, the target project gains the following AI agent-callable a
44
44
 
45
45
  | Command | Purpose |
46
46
  |---|---|
47
- | `docs-sync` | Clean workspace, sync project documentation from reproducible Git ranges |
47
+ | `docs-sync` | Clean workspace, sync project documentation and Agent handbooks from reproducible Git ranges |
48
48
  | `archive-and-consolidate` | Knowledge lifecycle governance: archive stale content, consolidate scattered knowledge, clean up outdated assets |
49
49
  | `retro` | Retrospective analysis with `gh issue` creation |
50
50
  | `status` | Summary of installed workflows, active changes, and anomalies |
51
51
 
52
- ### 7 Skills
52
+ ### 6 Skills
53
53
 
54
54
  | Skill | Purpose |
55
55
  |---|---|
56
- | `agents-md-builder` | Multi-layer AGENTS.md / CLAUDE.md handbook tree builder |
57
56
  | `archive-and-consolidate` | Archive stale content, consolidate scattered knowledge, and clean up outdated assets |
58
- | `docs-sync` | Core documentation audit and synchronization |
57
+ | `docs-sync` | Documentation audit plus incremental or full AGENTS.md / CLAUDE.md handbook synchronization |
59
58
  | `github-npm-ops` | GitHub issue/PR triage and npm operations |
60
59
  | `speculo-retro` | Retrospective analysis |
61
60
  | `typescript-standards-builder` | Interview-driven generator that produces a project-specific TypeScript/JS/React/Node standards skill |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@namewta/speculo",
3
- "version": "0.4.0",
3
+ "version": "0.5.0",
4
4
  "description": "Workflow-packaged specification-driven development assets with install, update, and migration tooling.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -1436,6 +1436,7 @@ SpecDev 通过分层工件避免同一决策被多个模型反复重做。每个
1436
1436
  | 分诊 | `specdev/changes/{change}/triage.md` | 请求类别、影响、风险、缺失输入和下一 work | 详细实现方案 |
1437
1437
  | 诊断 | `specdev/changes/{change}/diagnosis.md` | 复现、证据、根因、修复不变量和回归契约 | 未经验证的修复实现 |
1438
1438
  | 设计日志 | `specdev/changes/{change}/LOG.md` | 讨论轨迹、确认、延后、替代与废弃结论 | 当前架构权威摘要 |
1439
+ | 设计树 | `specdev/changes/{change}/design-tree.json` | 决策节点、依赖、当前 frontier、轮次与共识状态 | 领域真相或架构决定正文 |
1439
1440
  | 领域上下文 | `specdev/changes/{change}/CONTEXT.md` | 当前领域术语、语义和稳定不变量 | 临时会议记录 |
1440
1441
  | 架构决策 | `specdev/changes/{change}/ADR.md` | 已接受架构决策、原因、后果和替代关系 | 尚未决定的方案集合 |
1441
1442
  | Spec | `specdev/changes/{change}/spec.md` | 用户问题、外部行为、范围、验收合同、非功能要求和已锁定实现约束 | 文件级施工步骤 |
@@ -1443,6 +1444,10 @@ SpecDev 通过分层工件避免同一决策被多个模型反复重做。每个
1443
1444
  | Tickets Map | `specdev/changes/{change}/tickets-map.md` | 依赖 DAG、合同覆盖、Ready 投影、并行候选和路径冲突 | 单 Ticket 的完整实现契约 |
1444
1445
  | Goal Plan | `specdev/changes/{change}/goal-plan.md` | 跨 Ticket 调度、Gate、共享所有权、迁移顺序、集成和偏差治理 | 复制 Ticket 全文 |
1445
1446
  | Evidence | `specdev/changes/{change}/evidence/T-NN.md` | 实际修改、命令、结果、验收映射、偏差、风险和提交引用 | 新的产品或架构决策 |
1447
+ | Wayfinder 地图 | `specdev/changes/{change}/wayfinder-map.md` | 目的地、说明、已关闭决策索引、战争迷雾和范围之外 | 开放 Ticket 正文或答案详情 |
1448
+ | Wayfinder Ticket | `specdev/changes/{change}/investigation/{investigation-id}.md` | 一个可精确陈述的问题、类型、阻塞和关闭状态 | 解决方案评论或交付目标 |
1449
+ | Wayfinder solution comment | `specdev/changes/{change}/investigation/comments/{investigation-id}/NN-solution.md` | Ticket 的答案、结果事实和资产指针 | 地图索引或产品实现 |
1450
+ | 架构审查 | `specdev/changes/{change}/architecture-review.md` 与 `specdev/changes/{change}/architecture-review.html` | 深化候选、证据、可视化、选择和访谈状态 | 未经用户选择的执行契约 |
1446
1451
 
1447
1452
  ## 2. 权威顺序
1448
1453