-
Notifications
You must be signed in to change notification settings - Fork 2
Home
The PDCA memory loop for AI coding.
superpowers gives Claude discipline for one session. ai-coding-ok gives Claude memory that stays accurate across 50 iterations.
ai-coding-ok is an AI coding guardrail framework that installs a three-tier memory system into any project and enforces a PDCA (Plan → Do → Check → Act) closed loop on every coding task. It solves the problem of "AI fixed bug X and broke feature Y" by ensuring the AI reads project context before writing code and writes back to memory after finishing.
Works with: Claude Code · GitHub Copilot · Cursor · OpenCode
| 🆕 I'm new | 🔄 I'm already using it | 🔧 I want to contribute |
|---|---|---|
| Start here to install ai-coding-ok in your project for the first time. | Deepen your understanding and learn advanced patterns. | Help improve ai-coding-ok itself. |
| → Quick Start | → User Guide | → Contributing |
Pick your AI tool:
| Platform | Install Guide | Trigger Mechanism |
|---|---|---|
| Claude Code | Claude Code Installation |
/plugin install + install ai-coding-ok
|
| GitHub Copilot | Copilot Installation |
.github/copilot-instructions.md auto-load |
| Cursor | Cursor Installation |
.cursor/rules/ai-coding-ok.mdc (alwaysApply) |
After installation, run the Verification to confirm everything is wired up correctly.
Understand how ai-coding-ok works:
| Concept | Page | What you'll learn |
|---|---|---|
| 🔄 PDCA Workflow | PDCA Workflow | The Plan→Do→Check→Act loop that runs on every task |
| 🧠 Three-Tier Memory | Three-Tier Memory | Long-term, mid-term, and short-term memory files |
| 🎛️ Four Modes | Four Modes (A/B/C/D) | Install, Plan, Act, Upgrade — when each triggers |
| 🛡️ Five-Layer Defense | Five-Layer Defense | How v3.1+ guarantees PDCA is never skipped |
| Topic | Page |
|---|---|
| Day-to-day workflow | Daily Workflow |
| Customizing for your project | Customization Guide |
| Upgrading to the latest version | Upgrade ai-coding-ok |
| Using with superpowers | Combo with superpowers |
| Working in a team | Team Best Practices |
For those who want to understand the internals:
| Topic | Page |
|---|---|
| Complete file structure | File Structure |
| Template system design | Template System |
| Claude Code hooks mechanism | Hooks System |
| Version management & upgrade paths | Version Management |
| Placeholder system | Placeholder System |
| Topic | Page |
|---|---|
| Writing custom templates | Custom Templates |
| CI integration | CI Integration |
| Multi-project management | Multi-Project Management |
| Troubleshooting | Troubleshooting |
- FAQ — common questions, grouped by topic
- Changelog — version history with upgrade notes
- Contributing — how to contribute to ai-coding-ok
| License | MIT — free for commercial use |
| Latest version | v3.1.0 |
| Dependencies | Zero external dependencies (Shell + Python 3 stdlib + Markdown) |
| Repository | github.com/Mark7766/ai-coding-ok |
🧠 ai-coding-ok — AI 编程的 PDCA 记忆闭环。
GitHub · Issues · MIT License