Changelog

Changelog

Version history of ai-coding-ok. See Version Management for the upgrade path logic.

---

[v3.1.0] - 2026-06-08

Added

• Five-Layer Defense System — Mechanical enforcement of PDCA across five independent layers
• Claude Code Hooks — SessionStart, UserPromptSubmit, PreToolUse, and Stop hooks in .claude/settings.local.json
• CLAUDE.md STOP instruction — Hard STOP before any code work, invokes Skill
• AGENTS.md Plan phase 3→7 steps — Now reads all agent docs, not just memory files
• Install-time auto-configuration — Step 5.5 (source dir prompt) + Step 5.6 (hooks generation)
• {{SOURCE_DIR_PATTERN}} — New placeholder for hook source directory scoping

Modified

• AGENTS.md — Act phase adds "sync agent docs if stale" step
• copilot-instructions.md — Output format enforcement ("must include all sections")
• system-prompt.md — Act phase annotated "⚠️ must not skip"

Root cause

Text-only instructions ("must read memory") were insufficient — AI would skip PDCA in long sessions, short commands, and edge cases. Hooks provide mechanical constraints that cannot be bypassed.

---

[v3.0.1] - 2026-05-03

Fixed

• copilot-instructions.md — Output format now requires mandatory ## Memory Updates section; "should contain" → "must include"
• system-prompt.md — Act phase annotated "⚠️ must not skip"; defined legitimate skip conditions
• Both zh/ and en/ templates updated

Root cause

The Act phase was described as a task-list item but never embedded in the AI's response structure. Models would finish coding and end the response without triggering memory updates. The fix makes the ## Memory Updates section a required output section.

---

[v3.0.0] - 2026-05-01

Added

• Plugin packaging — .claude-plugin/plugin.json for /plugin install ai-coding-ok@claude-plugins-official
• Bilingual templates — templates/en/ and templates/zh/ with full language parity
• English README — New English root README; Chinese README preserved as README.zh.md
• --lang en|zh flag — install.sh and install.py language selection
• Canonical SKILL.md — skills/ai-coding-ok/SKILL.md as the authoritative skill definition

Modified

• All Chinese templates moved to templates/zh/
• install.sh / install.py: TEMPLATES_DIR now points to templates/$LANG
• All version markers bumped to v3.0.0

Backward compatibility

Legacy git-clone users (~/.claude/skills/ai-coding-ok/) are unaffected. Root SKILL.md still works. install.sh defaults to en (was previously Chinese).

---

[v2.2.0] - 2026-04-27

Added

• CLAUDE.md auto-load shim — @AGENTS.md import, Claude Code loads unconditionally at session start
• Conflict check — install.sh now checks for existing CLAUDE.md

Modified

• SKILL.md description — Rewritten command-first: "USE THIS SKILL FIRST on every coding task..." with bilingual trigger words
• All version markers bumped to v2.2.0

Why

In "new session + short command" scenarios, Claude Code would miss both the skill trigger and AGENTS.md heuristic read. CLAUDE.md (auto-loaded) + description rewrite (better matching) close this gap.

---

[v2.1.0] - 2026-04-26

Added

• Cursor support — .cursor/rules/ai-coding-ok.mdc with alwaysApply: true
• OpenCode support — --opencode install mode, global AGENTS.md injection
• install.py — install_opencode() function, --opencode and --cursor flags
• SKILL.md — compatibility: opencode, claude, cursor frontmatter

Modified

• install.sh interactive menu expanded to 5 options
• both mode updated to Claude Code + OpenCode

---

[v2.0] - 2026-04-19

Added

• PDCA mandatory instruction block — AGENTS.md and copilot-instructions.md top sections
• Version markers — <!-- ai-coding-ok: v2.0 --> on all template files
• Mode A/B/C/D — Install, Plan, Act, Upgrade modes in SKILL.md
• Upgrade Playbook — Mode D with diff-merge strategy
• superpowers compatibility — Dual-path PDCA coverage
• CHANGELOG.md — Version history tracking

Modified

• SKILL.md description — PDCA and Upgrade trigger words added
• workflows.md — Step 5 annotated "⚠️ Do not skip"
• workflows.md — Refactor scenario gained Step 4

Removed

• copilot-instructions.md — Footer section (replaced by top-level mandate)

---

[v1.0] - 2025

Initial release. Files without version markers are treated as v1.0.

Features

• Three-tier memory system (project-memory, decisions-log, task-history)
• PDCA workflow specification
• Coding standards and workflow guides
• Claude Code and GitHub Copilot dual-platform support

---

Next steps

• Version Management — how versioning and upgrades work
• Upgrade ai-coding-ok — how to upgrade your project
• GitHub Releases — release artifacts