deerwork-ai
Featured
deer-workflow
An open-source Dynamic Workflow runtime that combines deterministic TypeScript orchestration with replaceable Agent runtimes.
AI repository intelligence
FR-AI / ANALYSISWhy it is worth attention
It turns Codex native subagents into a governed delivery pipeline: role pins are checked, runtime metadata must match, missing evidence stops the lane, and the installer never overwrites existing agent files.
Who it is for
- Codex CLI or ChatGPT desktop users with custom agents enabled
- Teams building structured multi-agent software delivery workflows
- Engineering leads wanting enforced review and verification before completion
- Developers using GPT-5.6 Sol, Terra, and Luna at supported reasoning levels
Use cases
- Feature implementation where Sol produces specs and Luna/Terra implement them
- Higher-risk or context-heavy tasks routed to Terra with a fresh Sol review
- Ensuring no completion is reported until a fresh reviewer returns 'ship'
- Verifying installed role pins and runtime routing evidence before trusting a route
Strengths
- Explicit routing rules: Luna is default, Terra is selected for higher judgment/context/blast radius, and Sol reviews fresh
- No silent fallback: missing/stale/conflicting role/model/effort stops the affected lane
- Companion installer is careful: only installs missing templates, never overwrites differing files, and check verifies byte-for-byte
- Final review is a fresh Sol context with read-only sandbox request and verification of diff/evidence before ship
Considerations
- Requires current Codex CLI/desktop with plugins, native subagents, custom agents, and access to GPT-5.6 Sol/Terra/Luna
- Final review is context-independent but not model-family-independent; it is not cross-vendor review
- Custom agents must be installed separately, and a new Codex task is needed after install or update
README quick start
Sol Advisor
Sol runs the show. Luna handles routine implementation, Terra takes the harder builds, and a fresh Sol review with a requested read-only profile stands between the diff and done.
Sol Advisor is a Codex-native architect workflow for capability-routed software delivery. The primary session stays focused on requirements, architecture, specs, and verification while native Codex custom-agent threads handle implementation and review.
Go deeper
I write Attention Heads — deep, evidence-backed writing on AI, cognition, and agentic engineering. The Agentic Engineering Field Notes series is where I publish practical advice on the craft of using AI. Subscribe to get new posts to your inbox.
| Lane | Native agent type | Pinned profile | Use it for |
|---|---|---|---|
| Orchestrator | Primary session | GPT-5.6 Sol / High | Requirements, architecture, decomposition, routing, and acceptance |
| Routine implementation | sol_advisor_luna_implementer | GPT-5.6 Luna / Max | Mechanical, repeatable, fully specified work |
| Harder implementation | sol_advisor_terra_implementer | GPT-5.6 Terra / Max | Context-heavy, higher-risk, or wider-blast-radius work |
| Final review | sol_advisor_sol_reviewer | GPT-5.6 Sol / High / requests read-only | Fresh review of the actual diff and verification evidence |
The final review is context-independent, not model-family-independent: Sol reviews Sol's orchestration with a fresh context. That catches conversational assumptions, but it is not cross-vendor review.
Install from GitHub
Requirements:
- A current Codex CLI or ChatGPT desktop app with plugins, native subagents, and custom agents enabled.
- Access to GPT-5.6 Sol, Terra, and Luna at the required reasoning levels.
- jq, which the companion-install lookup uses to locate the installed plugin package.
Add the GitHub repository as a Codex marketplace, then install the plugin:
codex plugin marketplace add DannyMac180/sol-advisor --ref main
codex plugin add sol-advisor@sol-advisor
Install the companion custom agents
Plugin installation does not automatically install custom-agent files. That is intentional: the files are use
Description
Codex-native architect orchestration with Luna and Terra implementation lanes and mandatory fresh Sol review.
Related repositories
Similar projects matched by category, topics, and programming language.
jamesob
Featured
local-llm
A comprehensive guide for building and configuring a high-end local machine to run state-of-the-art LLMs, with detailed hardware choices, BIOS tuning, and Docker-based model serving.
mereyabdenbekuly-ctrl
Featured
clodex-ide
Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.