cairn-ai 0.1.2

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 (58) hide show
  1. package/.agents/workflows/cairn-doctor.md +22 -0
  2. package/.agents/workflows/cairn-install.md +17 -0
  3. package/.agents/workflows/cairn-memory.md +15 -0
  4. package/.agents/workflows/cairn-plan.md +21 -0
  5. package/.agents/workflows/cairn-review.md +14 -0
  6. package/.agents/workflows/cairn-toolcheck.md +17 -0
  7. package/.agents/workflows/cairn-uninstall.md +17 -0
  8. package/.agents/workflows/cairn-upgrade.md +17 -0
  9. package/.agents/workflows/cairn-work.md +20 -0
  10. package/.claude/agents/explorer.md +5 -0
  11. package/.claude/agents/worker.md +5 -0
  12. package/.claude/commands/cairn-doctor.md +13 -0
  13. package/.claude/commands/cairn-install.md +13 -0
  14. package/.claude/commands/cairn-memory.md +5 -0
  15. package/.claude/commands/cairn-plan.md +5 -0
  16. package/.claude/commands/cairn-review.md +5 -0
  17. package/.claude/commands/cairn-toolcheck.md +10 -0
  18. package/.claude/commands/cairn-uninstall.md +13 -0
  19. package/.claude/commands/cairn-upgrade.md +13 -0
  20. package/.claude/commands/cairn-work.md +5 -0
  21. package/.codex-plugin/plugin.json +30 -0
  22. package/LICENSE +21 -0
  23. package/README.de.md +130 -0
  24. package/README.es.md +130 -0
  25. package/README.fr.md +130 -0
  26. package/README.ja.md +130 -0
  27. package/README.ko.md +130 -0
  28. package/README.md +138 -0
  29. package/README.pt.md +130 -0
  30. package/README.zh.md +130 -0
  31. package/agents/explorer.md +31 -0
  32. package/agents/worker.md +32 -0
  33. package/commands/cairn-doctor.md +27 -0
  34. package/commands/cairn-install.md +24 -0
  35. package/commands/cairn-memory.md +17 -0
  36. package/commands/cairn-plan.md +23 -0
  37. package/commands/cairn-review.md +16 -0
  38. package/commands/cairn-toolcheck.md +19 -0
  39. package/commands/cairn-uninstall.md +24 -0
  40. package/commands/cairn-upgrade.md +23 -0
  41. package/commands/cairn-work.md +22 -0
  42. package/docs/model-guidance/README.md +31 -0
  43. package/docs/model-guidance/claude.md +46 -0
  44. package/docs/model-guidance/codex.md +48 -0
  45. package/hooks/hooks.json +65 -0
  46. package/package.json +49 -0
  47. package/scripts/cairn +115 -0
  48. package/scripts/cairn-lifecycle.mjs +343 -0
  49. package/scripts/cairn-state.sh +104 -0
  50. package/scripts/cairn-toolcheck.mjs +205 -0
  51. package/skills/cairn-memory/SKILL.md +40 -0
  52. package/skills/cairn-plan/SKILL.md +137 -0
  53. package/skills/cairn-review/SKILL.md +44 -0
  54. package/skills/cairn-work/SKILL.md +81 -0
  55. package/templates/MEMORY.md +14 -0
  56. package/templates/PLAN.md +17 -0
  57. package/templates/domain-memory.md +20 -0
  58. package/templates/work-plan.md +86 -0
@@ -0,0 +1,20 @@
1
+ # Domain: <name>
2
+
3
+ ## Scope
4
+
5
+ Describe the domain boundary covered by this note.
6
+
7
+ ## Facts
8
+
9
+ - Source:
10
+ - Evidence:
11
+ - Impact:
12
+
13
+ ## Policy
14
+
15
+ - Rule:
16
+ - Rationale:
17
+
18
+ ## References
19
+
20
+ - Path or command:
@@ -0,0 +1,86 @@
1
+ # Plan: <topic>
2
+
3
+ ## Goal
4
+
5
+ Describe the observable result.
6
+
7
+ ## Memory Inputs
8
+
9
+ - `MEMORY.md`
10
+ - `docs/memory/<domain>.md`
11
+
12
+ ## Model Guidance
13
+
14
+ - Applied model family: Codex or Claude.
15
+ - Referenced guidance:
16
+ - `docs/model-guidance/README.md`
17
+ - `docs/model-guidance/<claude-or-codex>.md`
18
+ - Rationale:
19
+ - Role-specific adjustment:
20
+ - User-visible output locale: OS locale unless the user asks for another language.
21
+
22
+ ## Complexity Triage
23
+
24
+ - Selected path: Light Path or Heavy Path.
25
+ - Selection rationale:
26
+ - Heavy Path trigger, if selected:
27
+ - Omitted delegation in Light Path, if applicable:
28
+ - Pre-implementation decisions:
29
+
30
+ ### Path Criteria
31
+
32
+ - Light Path: narrow changes inside existing architecture layers. Direct edit or one bounded `worker`, then focused verification.
33
+ - Heavy Path: new directory/module/layer, new domain model/service/abstraction, security/session/auth, external API/message queue/payment, DB schema/migration, concurrency/transaction/cache changes, cross-domain refactor, or explicit extra-care request.
34
+
35
+ ## Agent Assignments
36
+
37
+ - `explorer`: read-only discovery, impact analysis, pattern search, and read-only verification when available.
38
+ - `worker`: bounded implementation slices with clear file ownership, or scoped verification work.
39
+ - Local main session: urgent blocking work when the next step depends immediately on the result.
40
+
41
+ ## Tool Readiness
42
+
43
+ - Detected stack:
44
+ - Toolcheck command:
45
+ - Required LSP/symbol tools:
46
+ - Required typecheck/lint/verification tools:
47
+ - Missing tools:
48
+ - Install/bootstrap commands attempted:
49
+ - Tool blockers:
50
+
51
+ ## Execution Guardrails
52
+
53
+ - Dry-run or check mode before external-state mutation:
54
+ - No dry-run available, if applicable:
55
+ - Verification loop budget: two passes per slice by default.
56
+ - Failure handling: diagnose once, shrink or split the slice, rerun both gates, then record a blocker after the second failed pass.
57
+
58
+ ## Module Slices
59
+
60
+ ### Slice 1: <module>
61
+
62
+ - Contract:
63
+ - Files:
64
+ - Dependencies:
65
+ - Tool readiness requirement:
66
+ - Dry-run or check command:
67
+ - Module acceptance verification:
68
+ - Surface integration verification:
69
+
70
+ ## Evidence
71
+
72
+ - Dry-run or check:
73
+ - Tool readiness:
74
+ - Module acceptance:
75
+ - Surface integration:
76
+ - Verification pass count:
77
+ - Blocker after two failed passes:
78
+
79
+ ## Status
80
+
81
+ - [ ] Planned
82
+ - [ ] Dry-run or check passed, or not applicable was recorded
83
+ - [ ] Implemented
84
+ - [ ] Module acceptance passed
85
+ - [ ] Surface integration passed
86
+ - [ ] Reviewed