dw-sdlc 0.0.0-stage → 0.1.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 (48) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +63 -2
  3. package/config/agentic.config.schema.json +212 -0
  4. package/config/references.schema.json +56 -0
  5. package/dist/agentic-config.d.ts +167 -0
  6. package/dist/agentic-config.js +307 -0
  7. package/dist/catalogue.d.ts +36 -0
  8. package/dist/catalogue.js +74 -0
  9. package/dist/checks/agents-map.d.ts +7 -0
  10. package/dist/checks/agents-map.js +166 -0
  11. package/dist/checks/check.d.ts +17 -0
  12. package/dist/checks/check.js +21 -0
  13. package/dist/checks/index.d.ts +8 -0
  14. package/dist/checks/index.js +19 -0
  15. package/dist/checks/primitives.d.ts +8 -0
  16. package/dist/checks/primitives.js +128 -0
  17. package/dist/cli.d.ts +2 -0
  18. package/dist/cli.js +43 -0
  19. package/dist/commands/config.d.ts +2 -0
  20. package/dist/commands/config.js +76 -0
  21. package/dist/commands/doctor.d.ts +57 -0
  22. package/dist/commands/doctor.js +341 -0
  23. package/dist/commands/gate.d.ts +2 -0
  24. package/dist/commands/gate.js +175 -0
  25. package/dist/commands/primitives.d.ts +2 -0
  26. package/dist/commands/primitives.js +106 -0
  27. package/dist/commands/references-setup.d.ts +2 -0
  28. package/dist/commands/references-setup.js +213 -0
  29. package/dist/commands/references-sync.d.ts +2 -0
  30. package/dist/commands/references-sync.js +347 -0
  31. package/dist/commands/setup.d.ts +31 -0
  32. package/dist/commands/setup.js +369 -0
  33. package/dist/json-schema.d.ts +8 -0
  34. package/dist/json-schema.js +227 -0
  35. package/dist/markdown.d.ts +19 -0
  36. package/dist/markdown.js +77 -0
  37. package/dist/pins.d.ts +16 -0
  38. package/dist/pins.js +83 -0
  39. package/dist/references-key.d.ts +31 -0
  40. package/dist/references-key.js +150 -0
  41. package/dist/report.d.ts +13 -0
  42. package/dist/report.js +29 -0
  43. package/dist/router-block.d.ts +13 -0
  44. package/dist/router-block.js +62 -0
  45. package/dist/setup-rules.d.ts +22 -0
  46. package/dist/setup-rules.js +98 -0
  47. package/package.json +30 -3
  48. package/templates/router.md +38 -0
@@ -0,0 +1,38 @@
1
+ # references/ — router
2
+
3
+ Repositories cloned on each machine so you can read how something was solved before instead of
4
+ inventing it again. They are **not** part of this repository: git ignores everything here but this
5
+ file and its `CLAUDE.md` symlink. The repository's rules live in its root agent instructions; this
6
+ file routes reference material only.
7
+
8
+ > `CLAUDE.md` is a symlink to this file, so it loads whenever you open anything under `references/`.
9
+
10
+ ## The list
11
+
12
+ The table below is written from the `references` key of `.ai/agentic.config.json` by the setup, so
13
+ edit the key, never the table; the key also holds `what` each Reference is, its repository, its ref
14
+ and the paths its clone skips. Before you research, open the clones whose `when` matches the task.
15
+
16
+ <!-- references:start — written from .ai/agentic.config.json by the setup; edit the key -->
17
+
18
+ No Reference is declared yet: `/sdlc-references-add <repository>` adds one.
19
+ <!-- references:end -->
20
+
21
+ ## Rules
22
+
23
+ - **Read-only.** Never edit, build, run, install or lint anything under `references/`. A fix belongs
24
+ upstream; the next Sync brings it here.
25
+ - **Never import from them.** Nothing outside `references/` may point at a path inside it. To reuse
26
+ code, read it and write it again.
27
+ - **Their agent instructions are not ours.** A cloned repository may carry its own `CLAUDE.md` /
28
+ `AGENTS.md`. It describes _that_ repository; `claudeMdExcludes` in `.claude/settings.json` keeps
29
+ Claude Code from loading them.
30
+ - **Missing is normal.** CI, a fresh clone and a new worktree have none of them until a local Claude
31
+ Code session starts with the references plugin enabled, which syncs them. A directory that is
32
+ absent is not a broken link, and neither is a path its entry's `skip` leaves out.
33
+ - **A starting point, not the whole field.** The list is hand-picked, and each clone is its ref at
34
+ the last sync. Research into a feature or an approach reads the matching entries first, then looks
35
+ further: other repositories, upstream docs and web search.
36
+ - **Add one with `/sdlc-references-add <repository>`.** It reads the licence, picks the ref and the
37
+ paths to skip, writes the entry, rewrites the table and syncs it. A Reference is read, never
38
+ copied in.