How ercoledevs/codex-council works
Codex Council is a Codex plugin for turning software ideas and proposed changes into reviewed designs and, when authorized, implementation patches. Its main workflow begins with Mind’s guided decisions and review, proceeds through a Council verdict, and can hand an approved change to Hyper for implementation and check reporting. Forge and Alters provide additional design and review customization workflows. The Python CLI supports estimation and session operations; an optional Decision Runtime derives a separate, non-authoritative record. Edges reflect README statements and the source index; unsampled skill internals are not inferred.
Main entry points: codex_council.py Session CLI · codex-mind/SKILL.md Mind · codex-council/SKILL.md Council · codex-hyper/SKILL.md Hyper
Components 10
Design workflows
- Mind
skills/codex-mind/SKILL.md - Forge
skills/codex-forge/SKILL.md - Decision interview
scripts/council_interview.py
Session runtime
- Session CLI
scripts/codex_council.py - Decision Runtime
scripts/council_cells.py - Session artifacts
scripts/codex_council.py
Local customization
- Alters
skills/codex-council-alters/SKILL.md
Other components
- Codex user
Connections 13
- Codex user → Mind: starts with
README.md - Codex user → Forge: invokes directly
README.md - Codex user → Council: invokes directly
README.md - Codex user → Hyper: invokes directly
README.md - Codex user → Alters: invokes directly
README.md - Mind → Council: proposes and reviews
README.md - Council → Hyper: hands off approved change
README.md - Mind → Hyper: hands off authorized work
README.md - Codex user → Session CLI: estimates locally
README.md - Session CLI → Decision interview: imports
scripts/codex_council.py - Session CLI → Decision Runtime: imports
scripts/codex_council.py - Session CLI → Session artifacts: stores session data
README.md - Decision Runtime → Session artifacts: derives separate projection
README.md