ai-native-dev-stack

Conventional Commits 1.0 enforcer. Two complementary modes: (1) AUTO-SUGGEST — when you say "commit", "commit my changes", "commit this", or invoke `/commit`, the skill inspects `git diff --staged`, proposes 1–3 conventional commit messages (type + optional scope + subject), and asks which one to use. You never have to remember the format. (2) VALIDATOR — every `git commit` passes through a PreToolUse hook that validates the first line of the message against the Conventional Commits regex. Non-conformant commits trigger a confirm prompt — they cannot slip through silently. Types allowed: feat, fix, refactor, perf, docs, test, chore, build, ci, style, revert. Optional scope in parentheses (lowercase kebab-case, ≤ 20 chars). Optional `!` and `BREAKING CHANGE:` footer. Use when: "commit", "commit my changes", "make a commit", "commit this", "validate commit", "/commit". Proactively invoke whenever the user says "commit" or runs `git commit` through the agent, and after a logical unit

Check for and apply AI-Native Dev Stack updates, non-destructively. Detects whether the stack repo is behind upstream, shows what changed, and fast-forwards the shared clone — without ever touching your personalized configs (CLAUDE.md, Mavis agent.md, config.sh). Use when: "upgrade the stack", "update ai-native-dev-stack", "is the stack up to date?", "get the latest rules/method". Proactively suggest at the start of a session if an update is available.

Detect architecture-level technical debt: coupling, cycles, boundary violations, layer leaks. Outputs findings conforming to the debt-finding schema.

CRUD operations on the Debt Registry. Manages the active list of accepted debts, decisions, and resolution status. Persists to the KG (Layer 0).

Generate preventive rules (linters, tests, CI checks) from detected findings. Stops the same pattern from re-appearing after a fix.

Scan a codebase to detect technical debt (code, security, dependencies, tests, architecture). Orchestrate deterministic tools + LLM. Produce a `.debt-scan.json` file conforming to the schema.

Challenge every finding and plan before validation. Reduce hallucinations, force proofs, verify completeness.

Fix a specific finding in dry-run mode + mandatory human validation. Produce patches ready for PR.

Transform the findings of a debt-scan into a prioritized, complete action plan. Produce `plan.json` conforming to the schema + a readable `plan.md`.

Verify that a fix resolved the finding without introducing regression.

Trace the debt introduced by an MVP explicitly requested. Transform involuntary debt into an informed choice.

Full AI optimization stack health check for any codebase. 10-tier scorecard: AI docs, dependency graph, Obsidian memory vault, Claude Code memory, project quality gates, and skills ecosystem. Works for any language (C++, Rust, TypeScript, Python, Go, Java, etc.) and any project structure — no hardcoded paths. Auto-fixes stale summaries, stale graph, missing hooks. Prints install guide for new contributors when stack is missing. Use when: "verify ai docs", "check ai stack", "is everything up to date?", "ai health check", "verify optimization stack", "check my ai setup". Proactively suggest before a major push, when a new contributor joins, or at the start of a long coding session.

Project quality governance scorecard — verifies coding standards compliance across three enforcement tiers: CI gates, AI assistant rules (CLAUDE.md), and team governance (CODEOWNERS, RFC process). Produces a scored checklist with the next recommended action. Adapt the check list to your project's quality standards. Use when: "verify standards", "quality check", "standards audit", "check compliance", "how healthy is the codebase?". Proactively suggest before a major push, at the start of a long session, or after a significant refactor.