Inquiry
Analyze. Plan. Execute.
Currently available for GitHub Copilot. More targets coming soon.
v0.3.0Public 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 agents to your AI coding tool.
curl -fsSL https://inquiry.ccisne.dev/install.sh | bash
Installs to ~/.inquiry/ and deploys Inquiry agents to your AI coding tool.
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 bet is methodology over model: if the framework carries the weight, a smaller or free model following it should stay useful where freestyling falls apart.
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 constraints of the tests. 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 agent + skills to your AI tool (Copilot today) iq target get # scaffold .inquiry/ in your repo cd your-repo && iq init
Commands
iqPrint ASCII banner + versioniq initScaffold.inquiry/(state, config, mutations)iq doctorVerify prerequisitesiq target getDeploy agent + skills to AI tooliq 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
12 commands total — see the full table on GitHub.
Targets
Inquiry deploys agent prompts and skills to the global configuration of your AI coding tool.
- 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
Documentation map →
The authority-aware entry into architecture, research, specs, lore, and cleanrooms.
Meet the agents →
Four active agents — SOCRATES, DESCARTES, BASHŌ, DARWIN — and the honest story of five 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.