jared
/
cc-os
1
0
Fork 0
Code Issues 18 Pull Requests Packages Projects Releases Wiki Activity
cc-os/plugins/os-adr/skills/init/SKILL.md

1.0 KiB
Raw Permalink Blame History

description
Set up the ADR system (docs/adr/ + generated index) in a project that has none, and clear any session-reminder suppression. Invoked by `/os-adr:init`.

Initialize the standard ADR layout in the current project. Everything is mechanical — run the CLI, don't create the files yourself:

ruby ${CLAUDE_PLUGIN_ROOT}/bin/adr-init --root <project-root>

This creates docs/adr/ with a generated README.md index (empty table between markers, regenerated in full on every ADR write — never hand-edited), and deletes .os-adr/suppress if present so the SessionStart reminder resumes normal behavior.

It is idempotent: safe to run in a project that already has ADRs (the index is regenerated from the directory contents).

Afterwards:

  1. Ensure .os-adr/ is gitignored (append to .gitignore if the project has one and the entry is missing).
  2. If the project has existing ADR-like content in another shape, suggest /os-adr:migrate instead of re-authoring.
  3. Offer /os-adr:create to record the first decision.