Inquiry
Analyze. Plan. Execute.
Currently available for GitHub Copilot. More hosts coming soon.
v0.7.7Public entry surface. For the canonical documentation map, start in the repository docs.
irm https://inquiry.ccisne.dev/install.ps1 | iex
Installs to %LOCALAPPDATA%\inquiry\, adds to PATH, and deploys Inquiry skills to your AI coding host.
curl -fsSL https://inquiry.ccisne.dev/install.sh | bash
Installs to ~/.inquiry/ and deploys Inquiry skills to your AI coding host.
Inquiry structures AI-assisted work as a finite-state system with an explicit END gate and optional EVOLUTION pass. Inquiry names the cycle-level process, APE names the orchestrating methodology, and the Finite APE Machine names the engineered system that operationalizes both. The real wager is philosophical and methodological: AI becomes trustworthy when disciplined thinking tools such as questioning, decomposition, verification, and selection are made operational.
The phases
ANALYZE
Clarify the problem. Capture requirements, assumptions, and edge cases before any code is written.
diagnosis.mdPLAN
Decompose the work. Order the steps, verify each, enumerate nothing missed.
plan.mdEXECUTE
Implement under the active plan and coding manifesto. Each change small enough to merge confidently.
code + commitsBackward transitions from PLAN or EXECUTE back to ANALYZE are allowed — re-analysis is part of the contract.
Quick start
# verify prerequisites (inquiry, git, gh, gh auth) iq doctor # deploy Inquiry skills to your AI host (Copilot today) iq host get # scaffold .inquiry/ in your repo cd your-repo && iq init
Commands
iqPrint ASCII banner + versioniq initScaffold repo-scoped Inquiry files (.inquiry/config.yaml, ignore rules, agent)iq doctorVerify prerequisitesiq host getDeploy skills to the active AI hostiq fsm transitionExecute a deterministic FSM transitioniq fsm stateShow current FSM state as JSONiq ape promptAssemble sub-agent prompt from stateiq upgradeUpdate to the latest release
13 commands total — see the full table on GitHub.
Hosts
Inquiry deploys host-scoped skills to the global configuration of your AI coding tool. The repo-scoped agent is scaffolded by iq init.
- GitHub Copilot
- Claude Code
- Codex
- Crush
- Gemini
Adapters for Claude, Codex, Crush, and Gemini already exist — awaiting a stable agent prompt API before being wired in (ADR D20).
Go deeper
Architecture →
The canonical repository entry into the live Inquiry runtime, cycle, and operational model.
Meet the agents →
Five active agents — DEWEY, SOCRATES, DESCARTES, ADA, DARWIN — and the honest story of the larger roster that collapsed.
Methodology →
The FSM, the transition contract, memory-as-code, and the semantic risk matrix.
Finite APE Machine spec →
The current technical overview of the finite-state system and its supporting specifications.