git:20260608.fa142bd to git:20260702.2a34b56

1 added, 0 removed. Audit A to A.

# 8-habit-ai-dev

> A Claude Code and Codex plugin that adds workflow discipline to AI-assisted development. 24 on-demand skills across a 7-step workflow, grounded in Covey's 8 Habits. Cross-agent: installable in Claude Code and Codex, usable by any agent platform that can load markdown skills.

Repo: https://github.com/pitimon/8-habit-ai-dev

## Core entry points

- [AGENTS.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/AGENTS.md): Start here if you are not Claude Code. Install order for Codex and other agents, trust boundary, skill resolver pointer, common-tasks examples.

- [SPEC.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/SPEC.md): Project digest and fast session re-entry context for Codex and other agents.

- [DOMAIN.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/DOMAIN.md): Invariants, safety boundaries, operational constraints, and validation expectations.

- [CLAUDE.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/CLAUDE.md): Architecture reference for Claude Code. Plugin layout, skill authoring conventions, plugin boundary, skills-to-habits mapping.

- [README.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/README.md): Human-facing overview, quick start, decision tree, full skill reference.

- [SELF-CHECK.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/SELF-CHECK.md): Release checklist and integrity checks.

- [CONTRIBUTING.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/CONTRIBUTING.md): How to author new skills and run local validators.

- [skills/RESOLVER.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/skills/RESOLVER.md): Flat phrase-to-path dispatcher. Given user intent → which SKILL.md to read.

- [docs/data/skills.json](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/docs/data/skills.json): Generated machine-readable skill catalog for cross-agent discovery. Metadata only; not a runtime dispatcher.

- [docs/compatibility-matrix.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/docs/compatibility-matrix.md): Runtime compatibility contract across Claude Code, Codex, and other markdown-capable agents.

- [docs/codex-integration.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/docs/codex-integration.md): Codex install, verify, routing, adapter boundary, and release-flow guidance.

- [docs/adr/README.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/docs/adr/README.md): ADR index and authoring convention.

- [docs/adr/ADR-025-codex-project-context-files.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/docs/adr/ADR-025-codex-project-context-files.md): Decision record for root project context files and Codex setup notes.

- [.codex/README.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/.codex/README.md): Repo-local Codex setup notes and hook/config boundary.

- [docs/wiki/Limitations.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/docs/wiki/Limitations.md): User-facing boundaries, non-goals, runtime limits, and release-evidence expectations.

## Skills

- [skills/](https://github.com/pitimon/8-habit-ai-dev/tree/main/skills): 24 skill directories, each with `SKILL.md`. Read `skills/RESOLVER.md` first to pick the right one.

- [docs/data/skills.json](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/docs/data/skills.json): Stable JSON catalog generated from `skills/*/SKILL.md` frontmatter and body metadata.

- [CLAUDE.md § Skills → Habits Mapping](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/CLAUDE.md): Step-indexed skill table mapping each skill to a Covey habit.

## Philosophy

- [rules/effective-development.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/rules/effective-development.md): Covey's 8 Habits translated into Claude + human collaboration standards.

- [habits/](https://github.com/pitimon/8-habit-ai-dev/tree/main/habits): Per-habit deep dives loaded on demand by skills.

- [guides/integrity-principles.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/guides/integrity-principles.md): Evidence standards for reviews, cross-verification, and reflection.

- [guides/vendor-portability.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/guides/vendor-portability.md): Discipline for staying portable when adopting managed-agent platforms (memory, self-evaluation, orchestration).

- [guides/independent-source-verification.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/guides/independent-source-verification.md): Confirm a root cause from an independent source (different tool/command/vantage) and reconcile contradictions — catches confident-but-wrong diagnoses that survive every author-side gate.

- [guides/project-context-contract.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/guides/project-context-contract.md): Optional repo-local context contract for glossary, issue tracker, triage label, and ADR awareness across skills.

- [guides/templates/issue-tracking-comments.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/guides/templates/issue-tracking-comments.md): Pickup, progress/blocker, and completion comment drafts for issue-based work without automatic issue mutation.

- [guides/tdd-tracer-bullet.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/guides/tdd-tracer-bullet.md): Behavior-first TDD tracer-bullet loop through public interfaces; guidance only, no test runner.

+ - [guides/script-vs-ai-workflow.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/guides/script-vs-ai-workflow.md): The execution/verification boundary — when an AI workflow may substitute a repo script (execution behind a deterministic gate) and when it never may (verification); classifies all repo scripts.

- [docs/wiki/Limitations.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/docs/wiki/Limitations.md): Boundary and evidence expectations for users evaluating whether plugin behavior is in scope.

## Compliance

- [guides/eu-ai-act-mapping.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/guides/eu-ai-act-mapping.md): EU AI Act Articles 9-15 mapping to plugin skills.

- [guides/cross-verification.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/guides/cross-verification.md): 17-question 8-habit checklist with dimension summary.

- [guides/ears-notation.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/guides/ears-notation.md): EARS requirements syntax reference for `/requirements`.

- [SKILL-EFFECTIVENESS.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/SKILL-EFFECTIVENESS.md): Per-skill effectiveness signal ledger from `/reflect`.

## Cross-plugin boundary

- [CLAUDE.md § Plugin Boundary](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/CLAUDE.md): Rule of thumb for what belongs here (workflow discipline) vs. [pitimon/claude-governance](https://github.com/pitimon/claude-governance) (compliance enforcement + frameworks). Install both together for maximum coverage.

- [docs/adr/ADR-024-codex-runtime-adapter-boundary.md](https://raw.githubusercontent.com/pitimon/8-habit-ai-dev/main/docs/adr/ADR-024-codex-runtime-adapter-boundary.md): Codex runtime-adapter boundary. Native Codex packaging does not mean Claude hook parity; future automation wraps the markdown skill core instead of rewriting it.