@dotdotgod/claude-code 0.1.31 → 0.1.40

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 (2) hide show
  1. package/README.md +42 -66
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -2,91 +2,67 @@
2
2
 
3
3
  [![npm version](https://img.shields.io/npm/v/@dotdotgod/claude-code.svg)](https://www.npmjs.com/package/@dotdotgod/claude-code) [![GitHub](https://img.shields.io/badge/GitHub-dotdotgod%2Fdotdotgod--kit-181717?logo=github)](https://github.com/dotdotgod/dotdotgod-kit/tree/main/packages/claude-code) [![License: Elastic 2.0](https://img.shields.io/badge/License-Elastic%202.0-blue.svg)](../../LICENSE)
4
4
 
5
- > **Change a file, know what else must be checked.**
5
+ Claude Code adapter for dotdotgod's docs-first project-memory workflow.
6
6
 
7
- ```bash
8
- $ dotdotgod graph impact . --changed packages/cli/src/core.mjs --compact
9
- ```
10
-
11
- ```text
12
- docs:
13
- - docs/spec/REFERENCE_EXPANSION.md (91; incoming:implemented_by, semantic_similarity)
14
- - docs/test/REFERENCE_EXPANSION.md (65.3; verified_by, semantic_similarity)
15
- - docs/spec/LOAD_PROJECT.md (35.8; related_doc, semantic_similarity)
16
-
17
- tests:
18
- - packages/cli/test/core.test.mjs (78.6; semantic_similarity, incoming:semantic_similarity, verified_by)
19
- - packages/cli/test/e2e.test.mjs (51.4; verified_by)
20
-
21
- files:
22
- - packages/cli/src/core.mjs (100; changed-file)
23
- - packages/pi/extensions/plan-mode/index.ts (45; implemented_by, semantic_similarity)
24
- ```
25
-
26
- `graph impact` ranks the specs, tests, architecture notes, config docs, and source files most likely to matter for a change. `--compact` keeps the result agent-facing: grouped by docs/tests/files and annotated with the reasons each item is likely relevant. It uses the project-memory graph built from Markdown links, README routes, headings, traceability blocks, package metadata, memory areas, and deterministic routing hints.
27
-
28
- Claude Code adapter for dotdotgod's context curation workflow. It packages `/dd:init`, `/dd:load`, `/dd:plan`, `/dd:impact`, matching skills for those command workflows, and the `document-clarify` skill so Claude Code can start from the fixed load-context surface and use explicit maintained graph links instead of rediscovering specs, tests, plans, and archives from scratch.
7
+ Use this package when you want Claude Code to initialize shared project docs, load bounded repository context, plan from durable docs before implementation, and review changed files with graph-impact evidence before handoff.
29
8
 
30
- ## What Gets Better?
9
+ ## Start Here
31
10
 
32
- - `/dd:init` bootstraps shared agent instructions and docs folders for future context curation.
33
- - `/dd:load` prefers `dotdotgod load-snapshot <root> --json` when the CLI is available, then falls back to README-index reads.
34
- - Claude Code can use docs structure as retrieval intent: specs for behavior, architecture for rationale, tests for verification, plans for current work, and archive indexes for past decisions.
35
- - Planning guidance encourages agents to keep README routes, traceability blocks, plans, and archives current so `graph impact` remains useful.
36
- - `/dd:plan` writes or updates durable task intent in `docs/plan/<task-slug>/README.md` before implementation.
37
- - `/dd:impact` reviews changed files with `dotdotgod graph impact` before broad verification or handoff, giving Claude Code a Pi-like impact workflow without Pi runtime enforcement.
38
- - `document-clarify` improves project docs using memory-area roles and optional config guidance while preserving behavior contracts.
39
- - Product intent, design rationale, verification standards, and completed work stay in durable files rather than chat history.
40
- - Skills mirror the command workflows for init/load/plan/impact, and `document-clarify` adds a skill-only docs clarity workflow.
11
+ Install or register this package as a Claude Code plugin, then use the bundled `/dd:*` commands in your repository:
41
12
 
42
- ## Shared Memory and Traceability Model
43
-
44
- By default, `docs/spec/**` has two roles: it is stable shared/fresh project memory, and it is the traceability-enforced behavior-spec path. These concepts are independent:
45
-
46
- - `memory.areas` customizes memory classification, freshness, local/shared scope, priorities, archive-body inclusion, and optional document-area `description`/`clarify` guidance.
47
- - `traceability.required` / `traceability.exclude` customizes which markdown paths must end with `json dotdotgod` blocks.
48
-
49
- `docs/archive/README.md` is the history map. Archive bodies remain targeted historical memory and should not be read broadly by default.
13
+ ```text
14
+ /dd:init
15
+ /dd:load
16
+ /dd:plan Update the API migration plan.
17
+ /dd:impact
18
+ ```
50
19
 
51
- ## Included
20
+ For local development from this checkout:
52
21
 
53
- - Claude Code plugin manifest: `.claude-plugin/plugin.json`
54
- - Slash commands:
55
- - `/dd:init`: initialize shared agent docs and docs folders, using `dotdotgod init` when available and the bundled fallback when not.
56
- - `/dd:load`: load project memory read-only.
57
- - `/dd:plan`: plan from docs before implementation.
58
- - `/dd:impact`: review current changes with dotdotgod graph-impact evidence before broad verification or handoff.
59
- - Skills:
60
- - `project-load`
61
- - `doc-first-planning`
62
- - `project-initializer`
63
- - `impact-review`
64
- - `document-clarify`
22
+ ```bash
23
+ claude --plugin-dir /path/to/dotdotgod/packages/claude-code
24
+ ```
65
25
 
66
- ## Optional Hooks
26
+ ## What It Adds to Claude Code
67
27
 
68
- Claude Code can run local lifecycle hooks from Claude settings. dotdotgod does not require hooks: `/dd:init`, `/dd:load`, `/dd:plan`, `/dd:impact`, and the bundled skills work without them.
28
+ | Command or skill | Use it for | Result |
29
+ | --- | --- | --- |
30
+ | `/dd:init` | Start a repository with dotdotgod conventions. | Creates or normalizes `AGENTS.md`, thin agent entrypoints, docs indexes, active-plan space, and archive map. |
31
+ | `/dd:load` | Load project memory read-only. | Prefers `dotdotgod load-snapshot <root> --json`, then falls back to README-index reads. |
32
+ | `/dd:plan` | Plan before implementation. | Writes or updates durable task intent in `docs/plan/<task-slug>/README.md`. |
33
+ | `/dd:impact` | Review changed files before verification or handoff. | Uses `dotdotgod graph impact` to identify likely related docs, tests, commands, and source files. |
34
+ | `document-clarify` | Improve docs wording without changing behavior contracts. | Clarifies README/spec/test/arch/plan/archive docs using memory-area roles. |
69
35
 
70
- Use hooks only when you want opt-in reminders, validation, or local safety rails around the same SDLC loop: plan, implement, impact-review, verify, review, and archive. Claude Code plugins can ship hooks, but dotdotgod keeps hook behavior documented and opt-in rather than enabling default package hooks that might surprise users. The hook surface changes over time, so examples stay advisory and avoid claiming unavailable plan-mode transition hooks. See [`hooks/README.md`](hooks/README.md) for current lifecycle notes, advisory examples, and stricter plan-safety patterns.
36
+ The package also includes matching skills for init, load, planning, and impact-review workflows.
71
37
 
72
- ## Shared Contract
38
+ ## Shared Project-Memory Contract
73
39
 
74
40
  - `AGENTS.md` remains canonical.
75
41
  - `CLAUDE.md` stays thin and imports or points to `AGENTS.md`.
42
+ - Specs describe behavior and requirements.
43
+ - Architecture docs explain rationale, boundaries, and conventions.
44
+ - Test docs explain verification strategy, regression coverage, fixtures, and commands.
76
45
  - Active plans use `docs/plan/<task-slug>/README.md`.
77
46
  - Completed plans move to `docs/archive/plan/<task-slug>/`.
78
47
  - Temporary reports move to `docs/archive/report/<report-slug>/`.
79
48
  - `docs/archive/README.md` is the archive map; archive bodies should be read only when targeted.
80
49
 
81
- ## Local Development
50
+ ## Memory Areas and Traceability
82
51
 
83
- Use the package as a local Claude Code plugin directory while developing:
52
+ By default, `docs/spec/**` has two separate roles:
84
53
 
85
- ```bash
86
- claude --plugin-dir /path/to/dotdotgod/packages/claude-code
87
- ```
54
+ - It is stable shared project memory for product behavior and requirements.
55
+ - It is the traceability-enforced path for behavior specs.
88
56
 
89
- Run package checks:
57
+ Projects can customize memory roles with `memory.areas`, and can customize traceability requirements with `traceability.required` and `traceability.exclude`.
58
+
59
+ ## Optional Hooks
60
+
61
+ Claude Code can run local lifecycle hooks from Claude settings. dotdotgod does not require hooks: `/dd:init`, `/dd:load`, `/dd:plan`, `/dd:impact`, and the bundled skills work without them.
62
+
63
+ Use hooks only when you want opt-in reminders, validation, or local safety rails around the same loop: plan, implement, impact-review, verify, review, and archive. See [`hooks/README.md`](hooks/README.md) for current lifecycle notes and advisory examples.
64
+
65
+ ## Local Development
90
66
 
91
67
  ```bash
92
68
  pnpm --filter @dotdotgod/claude-code run verify
@@ -95,8 +71,8 @@ pnpm --filter @dotdotgod/claude-code run pack:dry-run
95
71
 
96
72
  ## Learn More
97
73
 
98
- See the [root README](../../README.md), [GitHub repository](https://github.com/dotdotgod/dotdotgod-kit), [`docs/concept/CONTEXT_CURATION.md`](../../docs/concept/CONTEXT_CURATION.md), [`docs/concept/CONTEXT_MECHANICS.md`](../../docs/concept/CONTEXT_MECHANICS.md), [`docs/spec/MEMORY_AREA_CONFIG.md`](../../docs/spec/MEMORY_AREA_CONFIG.md), and [`docs/spec/TRACEABILITY_CONFIG.md`](../../docs/spec/TRACEABILITY_CONFIG.md).
74
+ See the [root README](../../README.md), [GitHub repository](https://github.com/dotdotgod/dotdotgod-kit), [Context curation](../../docs/concept/CONTEXT_CURATION.md), [Context mechanics](../../docs/concept/CONTEXT_MECHANICS.md), [Memory area config](../../docs/spec/MEMORY_AREA_CONFIG.md), and [Traceability config](../../docs/spec/TRACEABILITY_CONFIG.md).
99
75
 
100
76
  ## Compared with Graphify-Style Memory
101
77
 
102
- This adapter is guidance-oriented. It asks Claude Code to prefer a bounded dotdotgod load snapshot when available, avoid broad archive scans, and follow README indexes before reading raw files. The strength is structured retrieval from explicit project-maintained links and the fixed docs surface, not a giant graph report.
78
+ This adapter is guidance-oriented. It asks Claude Code to prefer a bounded dotdotgod load snapshot, avoid broad archive scans, and follow README indexes before reading raw files. The strength is structured retrieval from explicit project-maintained links, not a giant graph report.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dotdotgod/claude-code",
3
- "version": "0.1.31",
3
+ "version": "0.1.40",
4
4
  "description": "Claude Code adapter for dotdotgod project memory workflows.",
5
5
  "type": "module",
6
6
  "license": "Elastic-2.0",