Skip to content

Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.

1.7 KB
Raw Blame

Decisions Example

Walk through repowise decision — list architectural decisions, review proposals, and read the health dashboard. No LLM key required for list/health.

Prerequisites

  1. A git repository with an index (repowise init, index-only is enough).
  2. repowise on PATH (uv tool install repowise or from this repo: uv sync --all-packages).
cd /path/to/your-repo
repowise init --yes --no-prose

Decisions are mined during indexing from inline markers, commits, and other sources documented in DECISIONS.md.

1. List and filter

repowise decision list
repowise decision list --proposed       # proposals needing review
repowise decision list --status active
repowise decision list --stale-only
repowise decision show <id>             # full record for one id

2. Health dashboard

repowise decision health

Shows active vs proposed counts, stale decisions, and hotspots that lack governing decisions.

3. Curate records (interactive)

repowise decision add                   # interactive add
repowise decision confirm <id>          # accept a proposal
repowise decision dismiss <id>          # reject; won't be re-proposed
repowise decision deprecate <id>        # mark superseded

Smoke checklist

Step Expected
repowise decision list Table of decisions (or "No decisions found")
repowise decision list --proposed Proposed rows only, or empty
repowise decision health Counts + ungoverned hotspot paths

Related docs