Home

8-Habit AI Dev

8-habit-ai-dev is a Claude Code and Codex plugin that adds workflow discipline to AI-assisted development. It ships portable markdown skills, a 7-step development workflow, and review habits grounded in Covey's 8 Habits.

Important

This plugin provides guidance, prompts, review structure, and documentation. It does not add runtime enforcement, policy authorization, compliance certification, cloud automation, or production mutation.

Start Here

Goal	Page
Install the plugin	Installation
Try the workflow once	Getting Started
Choose the right skill	Skills Reference
Understand the full process	Workflow Overview
Recover from common issues	Troubleshooting
Understand boundaries	Limitations

What You Get

Area	Included
Workflow	Steps 0-7 from research through monitoring
Skills	24 markdown skills for planning, review, operations, audit, and reflection
Runtime support	Claude Code package and native Codex package
Validation	Bash validators for skill structure, content, graph integrity, and hook budget
Documentation	Wiki pages generated from docs/wiki/ through PR review

Core Workflow

/research -> /requirements -> /design -> /breakdown
    -> /build-brief -> /review-ai -> /deploy-guide -> /monitor-setup

Most users should begin with two habits:

• Run /requirements before building non-trivial work.
• Run /review-ai before committing AI-generated work.

Use the full workflow for larger features, unclear domains, architecture changes, production deploys, or operational fixes.

Current Release Focus

Version v2.21.0 keeps the plugin's markdown-only boundary while improving cross-agent discovery:

• docs/data/skills.json exports generated skill metadata for cross-agent discovery.
• The frontmatter compatibility contract now documents Claude Code, Codex, and portable markdown expectations.
• /review-ai and /reflect include AI-work health and audit-evidence checkpoints.

Compatibility Boundary

Claude Code and Codex both consume the same markdown skills. Claude Code also has Claude-specific hooks and session reminders. Codex uses AGENTS.md, the Codex plugin manifest, and the same skills/ directory; if Codex invokes the package SessionStart hook, the hook returns JSON additional context rather than raw markdown.

For details, see Architecture, Limitations, Installation, and the repository compatibility docs.

Reference

• Workflow Overview
• Skills Reference
• Habits Reference - includes the Covey origin and engineering adaptation
• Maturity Model
• Architecture
• Limitations
• Changelog