llms.txt git:20260606.5622538A

Immutable. This exact content is served forever at /api/v1/blob/7bc0f7b740e69e2b.

# 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.
- [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.