continuous-improvement 3.12.3 → 3.16.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 (137) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/CHANGELOG.md +45 -1
  3. package/LICENSE +21 -21
  4. package/QUICKSTART.md +1 -1
  5. package/README.md +29 -8
  6. package/bin/analyze.sh +161 -161
  7. package/bin/backfill.mjs +19 -19
  8. package/bin/check-doc-runtime-claims.mjs +0 -0
  9. package/bin/check-docs-substrings.mjs +0 -0
  10. package/bin/check-everything-mirror.mjs +0 -0
  11. package/bin/check-routing-targets.mjs +0 -0
  12. package/bin/check-scripts-citation-drift.mjs +0 -0
  13. package/bin/check-skill-count-prose.mjs +168 -0
  14. package/bin/check-skill-count.mjs +32 -1
  15. package/bin/check-skill-law-tag.mjs +0 -0
  16. package/bin/check-skill-mirror.mjs +0 -0
  17. package/bin/check-skill-tiers.mjs +0 -0
  18. package/bin/check-test-imports-only.mjs +1 -1
  19. package/bin/check-third-party-shape.mjs +0 -0
  20. package/bin/check-tool-count.mjs +0 -0
  21. package/bin/companion-preference-status.mjs +0 -0
  22. package/bin/gateguard-clear.mjs +0 -0
  23. package/bin/generate-plugin-manifests.mjs +2 -1
  24. package/bin/harvest-friction.mjs +0 -0
  25. package/bin/hook-stats.mjs +21 -21
  26. package/bin/install.mjs +120 -2
  27. package/bin/lint-transcript.mjs +15 -3
  28. package/bin/mcp-server.mjs +66 -8
  29. package/bin/observe.mjs +0 -0
  30. package/bin/plan-pack.mjs +77 -0
  31. package/bin/pre-commit-block-strays.sh +0 -0
  32. package/bin/refresh-third-party.mjs +0 -0
  33. package/bin/unified-cli.mjs +55 -410
  34. package/commands/continuous-improvement.md +115 -115
  35. package/commands/dashboard.md +56 -56
  36. package/commands/model-forward.md +13 -0
  37. package/commands/production-readiness-review.md +53 -0
  38. package/commands/roast.md +34 -0
  39. package/commands/seven-laws.md +16 -16
  40. package/commands/ship.md +57 -0
  41. package/commands/workspace-surface-audit.md +77 -77
  42. package/hooks/companion-preference.mjs +31 -19
  43. package/hooks/gateguard.mjs +38 -16
  44. package/hooks/goal-drift-stop.mjs +0 -0
  45. package/hooks/hook-pack.mjs +110 -0
  46. package/hooks/observe.sh +0 -0
  47. package/hooks/recall-briefing.mjs +0 -0
  48. package/hooks/route-prompt.mjs +0 -0
  49. package/hooks/session.sh +106 -106
  50. package/hooks/three-section-close.mjs +0 -0
  51. package/hooks/workflow-distill.mjs +145 -0
  52. package/instinct-packs/go.json +58 -58
  53. package/instinct-packs/meta.json +16 -16
  54. package/instinct-packs/python.json +58 -58
  55. package/instinct-packs/react.json +58 -58
  56. package/lib/cli-anything.mjs +0 -0
  57. package/lib/gateguard-state.mjs +62 -13
  58. package/lib/goal-drift-gate.mjs +0 -0
  59. package/lib/goal-state.mjs +8 -4
  60. package/lib/hook-pack-gate.mjs +65 -0
  61. package/lib/install-targets.mjs +121 -0
  62. package/lib/observe-event.mjs +0 -0
  63. package/lib/plan-review-packet.mjs +96 -0
  64. package/lib/plugin-metadata.mjs +30 -4
  65. package/lib/pm-marketplace.mjs +0 -0
  66. package/lib/recall-briefing.mjs +0 -0
  67. package/lib/recall-index.mjs +0 -0
  68. package/lib/resolve-home-dir.mjs +0 -0
  69. package/lib/skill-distill.mjs +141 -0
  70. package/lib/skill-tiers.mjs +0 -0
  71. package/lib/version-check.mjs +115 -0
  72. package/llms.txt +2 -2
  73. package/package.json +6 -4
  74. package/plugins/beginner.json +2 -2
  75. package/plugins/continuous-improvement/.claude-plugin/marketplace.json +2 -2
  76. package/plugins/continuous-improvement/.claude-plugin/plugin.json +2 -2
  77. package/plugins/continuous-improvement/LICENSE +21 -21
  78. package/plugins/continuous-improvement/README.md +1 -1
  79. package/plugins/continuous-improvement/bin/backfill.mjs +19 -19
  80. package/plugins/continuous-improvement/bin/gateguard-clear.mjs +0 -0
  81. package/plugins/continuous-improvement/bin/mcp-server.mjs +66 -8
  82. package/plugins/continuous-improvement/bin/observe.mjs +0 -0
  83. package/plugins/continuous-improvement/commands/continuous-improvement.md +115 -115
  84. package/plugins/continuous-improvement/commands/dashboard.md +56 -56
  85. package/plugins/continuous-improvement/commands/model-forward.md +13 -0
  86. package/plugins/continuous-improvement/commands/production-readiness-review.md +53 -0
  87. package/plugins/continuous-improvement/commands/roast.md +34 -0
  88. package/plugins/continuous-improvement/commands/seven-laws.md +16 -16
  89. package/plugins/continuous-improvement/commands/ship.md +57 -0
  90. package/plugins/continuous-improvement/commands/workspace-surface-audit.md +77 -77
  91. package/plugins/continuous-improvement/hooks/companion-preference.mjs +31 -19
  92. package/plugins/continuous-improvement/hooks/gateguard.mjs +38 -16
  93. package/plugins/continuous-improvement/hooks/goal-drift-stop.mjs +0 -0
  94. package/plugins/continuous-improvement/hooks/hook-pack.mjs +110 -0
  95. package/plugins/continuous-improvement/hooks/hooks.json +16 -1
  96. package/plugins/continuous-improvement/hooks/observe.sh +0 -0
  97. package/plugins/continuous-improvement/hooks/recall-briefing.mjs +0 -0
  98. package/plugins/continuous-improvement/hooks/route-prompt.mjs +0 -0
  99. package/plugins/continuous-improvement/hooks/session.sh +106 -106
  100. package/plugins/continuous-improvement/hooks/three-section-close.mjs +0 -0
  101. package/plugins/continuous-improvement/hooks/workflow-distill.mjs +145 -0
  102. package/plugins/continuous-improvement/instinct-packs/go.json +58 -58
  103. package/plugins/continuous-improvement/instinct-packs/meta.json +16 -16
  104. package/plugins/continuous-improvement/instinct-packs/python.json +58 -58
  105. package/plugins/continuous-improvement/instinct-packs/react.json +58 -58
  106. package/plugins/continuous-improvement/lib/gateguard-state.mjs +62 -13
  107. package/plugins/continuous-improvement/lib/goal-drift-gate.mjs +0 -0
  108. package/plugins/continuous-improvement/lib/goal-state.mjs +8 -4
  109. package/plugins/continuous-improvement/lib/hook-pack-gate.mjs +65 -0
  110. package/plugins/continuous-improvement/lib/observe-event.mjs +0 -0
  111. package/plugins/continuous-improvement/lib/plugin-metadata.mjs +30 -4
  112. package/plugins/continuous-improvement/lib/recall-briefing.mjs +0 -0
  113. package/plugins/continuous-improvement/lib/recall-index.mjs +0 -0
  114. package/plugins/continuous-improvement/lib/resolve-home-dir.mjs +0 -0
  115. package/plugins/continuous-improvement/lib/skill-distill.mjs +141 -0
  116. package/plugins/continuous-improvement/skills/README.md +2 -1
  117. package/plugins/continuous-improvement/skills/gateguard/SKILL.md +4 -4
  118. package/plugins/continuous-improvement/skills/goal-monitor/SKILL.md +1 -1
  119. package/plugins/continuous-improvement/skills/handoff/SKILL.md +0 -1
  120. package/plugins/continuous-improvement/skills/model-forward/SKILL.md +44 -0
  121. package/plugins/continuous-improvement/skills/roast/SKILL.md +108 -0
  122. package/plugins/continuous-improvement/skills/strategic-compact/SKILL.md +12 -32
  123. package/plugins/continuous-improvement/skills/tdd-workflow/SKILL.md +411 -411
  124. package/plugins/expert.json +5 -1
  125. package/skills/README.md +5 -3
  126. package/skills/gateguard.md +4 -4
  127. package/skills/goal-monitor.md +1 -1
  128. package/skills/handoff.md +0 -1
  129. package/skills/model-forward.md +44 -0
  130. package/skills/roast.md +108 -0
  131. package/skills/strategic-compact.md +12 -32
  132. package/skills/tdd-workflow.md +411 -411
  133. package/lib/compound-engineering.mjs +0 -831
  134. package/lib/pm-skills.mjs +0 -1274
  135. package/lib/unified-plugin.mjs +0 -924
  136. package/plugins/continuous-improvement/skills/para-memory-files/SKILL.md +0 -108
  137. package/skills/para-memory-files.md +0 -108
@@ -1,108 +0,0 @@
1
- ---
2
- name: para-memory-files
3
- tier: "1"
4
- description: >
5
- Enforces Law 5 (Reflect After Every Session) and Law 7 (Learn From Every Session)
6
- of the 7 Laws of AI Agent Discipline by giving the agent a durable file-based
7
- memory it can read on resume and write at session end.
8
- File-based memory system using Tiago Forte's PARA method. Use this skill whenever
9
- you need to store, retrieve, update, or organize knowledge across sessions. Covers
10
- three memory layers: (1) Knowledge graph in PARA folders with atomic YAML facts,
11
- (2) Daily notes as raw timeline, (3) Tacit knowledge about user patterns. Also
12
- handles planning files, memory decay, weekly synthesis, and recall via qmd.
13
- Trigger on any memory operation: saving facts, writing daily notes, creating
14
- entities, running weekly synthesis, recalling past context, or managing plans.
15
- ---
16
-
17
- # PARA Memory Files
18
-
19
- Persistent, file-based memory organized by Tiago Forte's PARA method. Three layers: a knowledge graph, daily notes, and tacit knowledge. All paths are relative to `$AGENT_HOME`.
20
-
21
- ## Three Memory Layers
22
-
23
- ### Layer 1: Knowledge Graph (`$AGENT_HOME/life/` -- PARA)
24
-
25
- Entity-based storage. Each entity gets a folder with two tiers:
26
-
27
- 1. `summary.md` -- quick context, load first.
28
- 2. `items.yaml` -- atomic facts, load on demand.
29
-
30
- ```text
31
- $AGENT_HOME/life/
32
- projects/ # Active work with clear goals/deadlines
33
- <name>/
34
- summary.md
35
- items.yaml
36
- areas/ # Ongoing responsibilities, no end date
37
- people/<name>/
38
- companies/<name>/
39
- resources/ # Reference material, topics of interest
40
- <topic>/
41
- archives/ # Inactive items from the other three
42
- index.md
43
- ```
44
-
45
- **PARA rules:**
46
-
47
- - **Projects** -- active work with a goal or deadline. Move to archives when complete.
48
- - **Areas** -- ongoing (people, companies, responsibilities). No end date.
49
- - **Resources** -- reference material, topics of interest.
50
- - **Archives** -- inactive items from any category.
51
-
52
- **Fact rules:**
53
-
54
- - Save durable facts immediately to `items.yaml`.
55
- - Weekly: rewrite `summary.md` from active facts.
56
- - Never delete facts. Supersede instead (`status: superseded`, add `superseded_by`).
57
- - When an entity goes inactive, move its folder to `$AGENT_HOME/life/archives/`.
58
-
59
- **When to create an entity:**
60
-
61
- - Mentioned 3+ times, OR
62
- - Direct relationship to the user (family, coworker, partner, client), OR
63
- - Significant project or company in the user's life.
64
- - Otherwise, note it in daily notes.
65
-
66
- Atomic facts in `items.yaml` use the fields `id`, `created`, `content`, and optional `status` (`active` or `superseded`) with `superseded_by` pointing to the replacing fact. Memory decay is manual: rewrite `summary.md` weekly from active facts and move inactive entity folders to `archives/`.
67
-
68
- ### Layer 2: Daily Notes (`$AGENT_HOME/memory/YYYY-MM-DD.md`)
69
-
70
- Raw timeline of events -- the "when" layer.
71
-
72
- - Write continuously during conversations.
73
- - Extract durable facts to Layer 1 during heartbeats.
74
-
75
- ### Layer 3: Tacit Knowledge (`$AGENT_HOME/MEMORY.md`)
76
-
77
- How the user operates -- patterns, preferences, lessons learned.
78
-
79
- - Not facts about the world; facts about the user.
80
- - Update whenever you learn new operating patterns.
81
-
82
- ## Write It Down -- No Mental Notes
83
-
84
- Memory does not survive session restarts. Files do.
85
-
86
- - Want to remember something -> WRITE IT TO A FILE.
87
- - "Remember this" -> update `$AGENT_HOME/memory/YYYY-MM-DD.md` or the relevant entity file.
88
- - Learn a lesson -> update AGENTS.md, TOOLS.md, or the relevant skill file.
89
- - Make a mistake -> document it so future-you does not repeat it.
90
- - On-disk text files are always better than holding it in temporary context.
91
-
92
- ## Memory Recall -- Use qmd
93
-
94
- Use `qmd` rather than grepping files:
95
-
96
- ```bash
97
- qmd query "what happened at Christmas" # Semantic search with reranking
98
- qmd search "specific phrase" # BM25 keyword search
99
- qmd vsearch "conceptual question" # Pure vector similarity
100
- ```
101
-
102
- Index your personal folder: `qmd index $AGENT_HOME`
103
-
104
- Vectors + BM25 + reranking finds things even when the wording differs.
105
-
106
- ## Planning
107
-
108
- Keep plans in timestamped files in `plans/` at the project root (outside personal memory so other agents can access them). Use `qmd` to search plans. Plans go stale -- if a newer plan exists, do not confuse yourself with an older version. If you notice staleness, update the file to note what it is supersededBy.
@@ -1,108 +0,0 @@
1
- ---
2
- name: para-memory-files
3
- tier: "1"
4
- description: >
5
- Enforces Law 5 (Reflect After Every Session) and Law 7 (Learn From Every Session)
6
- of the 7 Laws of AI Agent Discipline by giving the agent a durable file-based
7
- memory it can read on resume and write at session end.
8
- File-based memory system using Tiago Forte's PARA method. Use this skill whenever
9
- you need to store, retrieve, update, or organize knowledge across sessions. Covers
10
- three memory layers: (1) Knowledge graph in PARA folders with atomic YAML facts,
11
- (2) Daily notes as raw timeline, (3) Tacit knowledge about user patterns. Also
12
- handles planning files, memory decay, weekly synthesis, and recall via qmd.
13
- Trigger on any memory operation: saving facts, writing daily notes, creating
14
- entities, running weekly synthesis, recalling past context, or managing plans.
15
- ---
16
-
17
- # PARA Memory Files
18
-
19
- Persistent, file-based memory organized by Tiago Forte's PARA method. Three layers: a knowledge graph, daily notes, and tacit knowledge. All paths are relative to `$AGENT_HOME`.
20
-
21
- ## Three Memory Layers
22
-
23
- ### Layer 1: Knowledge Graph (`$AGENT_HOME/life/` -- PARA)
24
-
25
- Entity-based storage. Each entity gets a folder with two tiers:
26
-
27
- 1. `summary.md` -- quick context, load first.
28
- 2. `items.yaml` -- atomic facts, load on demand.
29
-
30
- ```text
31
- $AGENT_HOME/life/
32
- projects/ # Active work with clear goals/deadlines
33
- <name>/
34
- summary.md
35
- items.yaml
36
- areas/ # Ongoing responsibilities, no end date
37
- people/<name>/
38
- companies/<name>/
39
- resources/ # Reference material, topics of interest
40
- <topic>/
41
- archives/ # Inactive items from the other three
42
- index.md
43
- ```
44
-
45
- **PARA rules:**
46
-
47
- - **Projects** -- active work with a goal or deadline. Move to archives when complete.
48
- - **Areas** -- ongoing (people, companies, responsibilities). No end date.
49
- - **Resources** -- reference material, topics of interest.
50
- - **Archives** -- inactive items from any category.
51
-
52
- **Fact rules:**
53
-
54
- - Save durable facts immediately to `items.yaml`.
55
- - Weekly: rewrite `summary.md` from active facts.
56
- - Never delete facts. Supersede instead (`status: superseded`, add `superseded_by`).
57
- - When an entity goes inactive, move its folder to `$AGENT_HOME/life/archives/`.
58
-
59
- **When to create an entity:**
60
-
61
- - Mentioned 3+ times, OR
62
- - Direct relationship to the user (family, coworker, partner, client), OR
63
- - Significant project or company in the user's life.
64
- - Otherwise, note it in daily notes.
65
-
66
- Atomic facts in `items.yaml` use the fields `id`, `created`, `content`, and optional `status` (`active` or `superseded`) with `superseded_by` pointing to the replacing fact. Memory decay is manual: rewrite `summary.md` weekly from active facts and move inactive entity folders to `archives/`.
67
-
68
- ### Layer 2: Daily Notes (`$AGENT_HOME/memory/YYYY-MM-DD.md`)
69
-
70
- Raw timeline of events -- the "when" layer.
71
-
72
- - Write continuously during conversations.
73
- - Extract durable facts to Layer 1 during heartbeats.
74
-
75
- ### Layer 3: Tacit Knowledge (`$AGENT_HOME/MEMORY.md`)
76
-
77
- How the user operates -- patterns, preferences, lessons learned.
78
-
79
- - Not facts about the world; facts about the user.
80
- - Update whenever you learn new operating patterns.
81
-
82
- ## Write It Down -- No Mental Notes
83
-
84
- Memory does not survive session restarts. Files do.
85
-
86
- - Want to remember something -> WRITE IT TO A FILE.
87
- - "Remember this" -> update `$AGENT_HOME/memory/YYYY-MM-DD.md` or the relevant entity file.
88
- - Learn a lesson -> update AGENTS.md, TOOLS.md, or the relevant skill file.
89
- - Make a mistake -> document it so future-you does not repeat it.
90
- - On-disk text files are always better than holding it in temporary context.
91
-
92
- ## Memory Recall -- Use qmd
93
-
94
- Use `qmd` rather than grepping files:
95
-
96
- ```bash
97
- qmd query "what happened at Christmas" # Semantic search with reranking
98
- qmd search "specific phrase" # BM25 keyword search
99
- qmd vsearch "conceptual question" # Pure vector similarity
100
- ```
101
-
102
- Index your personal folder: `qmd index $AGENT_HOME`
103
-
104
- Vectors + BM25 + reranking finds things even when the wording differs.
105
-
106
- ## Planning
107
-
108
- Keep plans in timestamped files in `plans/` at the project root (outside personal memory so other agents can access them). Use `qmd` to search plans. Plans go stale -- if a newer plan exists, do not confuse yourself with an older version. If you notice staleness, update the file to note what it is supersededBy.