release: v0.2.0

.adr-toolkit.json

@@ -0,0 +1,4 @@
+{
+  "schema_version": 1,
+  "locale": "en"
+}

.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "adr-toolkit",
-  "version": "0.1.0",
-  "description": "Initialize, record, and check Architecture Decision Records by inspecting the repository before asking questions."
+  "version": "0.2.0",
+  "description": "Initialize, record, and check Architecture Decision Records by inspecting the repository and existing decisions before asking questions."
 }

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,39 @@
+---
+name: Bug report
+about: Report a defect in ADR Toolkit
+title: ""
+labels: bug
+---
+
+## Summary
+
+## Steps to Reproduce
+
+1.
+2.
+3.
+
+## Expected Behavior
+
+## Actual Behavior
+
+## Environment
+
+- Harness: Claude Code / Codex CLI / Gemini CLI / Antigravity CLI / generic / other
+- ADR Toolkit version (`skills/adr-toolkit/VERSION`):
+- OS:
+
+## Relevant Output
+
+Paste the command and its output, including `--json` output where
+applicable.
+
+```
+```
+
+## Scope
+
+- [ ] This affects `adr.py validate`, `create`, `index`, `check`, `graph`,
+      or `search`.
+- [ ] This affects a specific harness adapter (Codex, Gemini CLI,
+      Antigravity, or generic).

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature request
+about: Propose new functionality for ADR Toolkit
+title: ""
+labels: enhancement
+---
+
+## Problem
+
+What are you trying to do that ADR Toolkit does not support today?
+
+## Proposed Solution
+
+## Alternatives Considered
+
+## Additional Context
+
+- [ ] I checked `project-roadmap.md` and `improvements.md` for existing
+      plans that already cover this.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,22 @@
+## Summary
+
+- 
+
+## ADR Impact
+
+- [ ] I checked whether this changes an accepted architectural decision.
+- [ ] I linked related ADRs, or this PR has no ADR impact.
+- [ ] I ran `adr.py check` when the change touches governed paths.
+
+Related ADRs:
+
+## Verification
+
+- [ ] `python3 -m pytest -q`
+- [ ] `python3 scripts/sync_version.py --check`
+- [ ] `python3 skills/adr-toolkit/scripts/adr.py validate --dir docs/decisions --json`
+- [ ] `python3 skills/adr-toolkit/scripts/adr.py index --dir docs/decisions --json`
+
+## Notes
+
+- 

.github/workflows/test.yml

@@ -32,5 +32,66 @@ jobs:
         run: pip install pytest
       - name: Run tests
         run: python -m pytest tests/unit tests/integration -v
-      - name: Check manifest versions are in sync
+
+  version-drift:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Check manifest versions and descriptions are in sync
         run: python scripts/sync_version.py --check
+
+  harness-parity:
+    # Installs the real Codex CLI and Gemini CLI and drives their own plugin
+    # commands against this repo, the same way a contributor would. Manifest
+    # JSON shape is already covered by tests/unit/test_*_adapter.py; this job
+    # instead proves discovery -> install -> list -> the installed skill
+    # package's script layer still runs, so an upstream CLI change or a
+    # manifest edit that breaks real installation fails CI instead of
+    # surfacing later as a user-reported install failure. Antigravity CLI
+    # (agy) has no public package registry distribution, so it stays a
+    # manually verified adapter only -- see adapters/antigravity/README.md.
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install Codex CLI
+        run: npm install -g @openai/codex@0.151.0
+      - name: Install Gemini CLI
+        run: npm install -g @google/gemini-cli@0.46.0
+      - name: Verify Codex CLI adapter end to end
+        run: |
+          set -euo pipefail
+          export CODEX_HOME="$(mktemp -d)"
+          REPO_ROOT="$(pwd)"
+          codex plugin marketplace add "$REPO_ROOT"
+          INSTALLED_PATH="$(codex plugin add adr-toolkit@adr-toolkit-marketplace --json | jq -r '.installedPath')"
+          codex plugin list
+          SCRATCH="$(mktemp -d)"
+          cd "$SCRATCH" && git init -q
+          python3 "$INSTALLED_PATH/skills/adr-toolkit/scripts/adr.py" preflight --json | jq -e '.ok == true'
+          python3 "$INSTALLED_PATH/skills/adr-toolkit/scripts/adr.py" init --dir docs/decisions --json | jq -e '.ok == true'
+          python3 "$INSTALLED_PATH/skills/adr-toolkit/scripts/adr.py" validate --dir docs/decisions --json | jq -e '.ok == true'
+      - name: Verify Gemini CLI adapter end to end
+        run: |
+          set -euo pipefail
+          REPO_ROOT="$(pwd)"
+          mkdir -p adapters/gemini-cli/skills
+          ln -s "$REPO_ROOT/skills/adr-toolkit" adapters/gemini-cli/skills/adr-toolkit
+          export HOME="$(mktemp -d)"
+          gemini extensions validate "$REPO_ROOT/adapters/gemini-cli"
+          printf 'y\ny\n' | gemini extensions install "$REPO_ROOT/adapters/gemini-cli" --consent
+          gemini extensions list
+          INSTALLED_PATH="$HOME/.gemini/extensions/adr-toolkit"
+          SCRATCH="$(mktemp -d)"
+          cd "$SCRATCH" && git init -q
+          python3 "$INSTALLED_PATH/skills/adr-toolkit/scripts/adr.py" preflight --json | jq -e '.ok == true'
+          python3 "$INSTALLED_PATH/skills/adr-toolkit/scripts/adr.py" init --dir docs/decisions --json | jq -e '.ok == true'
+          python3 "$INSTALLED_PATH/skills/adr-toolkit/scripts/adr.py" validate --dir docs/decisions --json | jq -e '.ok == true'

.gitignore

@@ -2,10 +2,36 @@ __pycache__/
 *.pyc
 .pytest_cache/
 *.egg-info/
+.coverage
+htmlcov/
+dist/
+build/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Editor/IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+
+# Local secrets/config — never commit real credentials
+.env
+.env.*.local
 
 # Adapter install-time symlinks. Every adapter README tells the user to
 # create these inside this working tree; committing a real symlink breaks
 # Windows checkouts without core.symlinks, which the CI matrix includes.
 adapters/codex/skills/adr-toolkit
 adapters/gemini-cli/skills/adr-toolkit
 adapters/antigravity/skills/adr-toolkit
+
+# Task-by-task implementation plans (superpowers subagent-driven-development
+# artifacts) — kept locally for reference, not part of the public tree.
+# docs/superpowers/specs/ (the design docs) stay tracked; only plans/ is
+# excluded. History from before this commit still has them if ever needed.
+docs/superpowers/plans/

CODE_OF_CONDUCT.md

@@ -0,0 +1,44 @@
+# Code of Conduct
+
+## Our Standard
+
+Participation in this project — issues, pull requests, discussions, and
+reviews — is expected to stay respectful and focused on the technical
+problem. Disagreement about a decision or an approach is normal; personal
+attacks, harassment, discriminatory language, or deliberately derailing a
+discussion are not.
+
+## Expected Behavior
+
+- Assume good faith and give reviewers/contributors the benefit of the
+  doubt.
+- Keep feedback specific to the code, design, or decision under
+  discussion.
+- Accept that maintainers may decline a change and explain why, without
+  that being an invitation to escalate.
+
+## Unacceptable Behavior
+
+- Harassment, insults, or discriminatory remarks directed at a person
+  rather than their contribution.
+- Publishing others' private information without consent.
+- Sustained disruption of issues, pull requests, or reviews.
+
+## Reporting
+
+Report a violation privately to the repository owner rather than escalating
+in a public issue or pull request thread. Include what happened, where
+(link to the issue/PR/comment), and when.
+
+## Enforcement
+
+The repository owner reviews reports and may edit or remove content, warn a
+participant, or restrict further participation in the project's spaces,
+proportional to the violation. Enforcement decisions are not owed a public
+explanation when doing so would expose reporter identity or private
+details.
+
+## Scope
+
+This applies to all project spaces (issues, pull requests, discussions,
+commits, and comments) and to representing the project in public spaces.

CONTRIBUTING.md

@@ -0,0 +1,48 @@
+# Contributing
+
+Thanks for helping improve ADR Toolkit. This project is intentionally small:
+the agent can reason and draft, but deterministic scripts own file writes,
+IDs, lifecycle transitions, validation, indexes, and machine-readable output.
+
+## Branches
+
+Follow the repository policy in `AGENTS.md`.
+
+- Branch from `develop` for normal work.
+- Use `feature/*`, `fix/*`, or `docs/*` for short-lived work branches.
+- Merge normal work back to `develop` through a pull request.
+- Release branches merge to `master` and back to `develop`.
+- Tags named `v*` are created only from `master`.
+
+## Local Checks
+
+Run the relevant checks before opening a pull request:
+
+```bash
+python3 -m pytest -q
+python3 scripts/sync_version.py --check
+python3 skills/adr-toolkit/scripts/adr.py validate --dir docs/decisions --json
+python3 skills/adr-toolkit/scripts/adr.py index --dir docs/decisions --json
+```
+
+For changes that may affect accepted architectural decisions, also run:
+
+```bash
+python3 skills/adr-toolkit/scripts/adr.py check --uncommitted --dir docs/decisions --json
+```
+
+## ADR Changes
+
+- Keep ADR source files flat under `docs/decisions/`.
+- Do not hand-edit generated indexes or lifecycle links to repair validation
+  errors. Change the source ADR or use the lifecycle command.
+- Use `adr.py create`, `status`, `deprecate`, `supersede`, and `exception` for
+  deterministic mutations.
+- Accepted ADRs are append-only in spirit: use supersession for changed
+  decisions instead of rewriting history.
+
+## Public Repository Hygiene
+
+Public repository branch/tag protection is expected to enforce PRs, required
+checks, conversation resolution, and force-push/deletion restrictions on
+`develop`, `master`, and `v*` tags once the repository is public.