Deep Discovery
Deep Discovery is a Codex plugin that adds the deep-discovery skill for a
100-question self-interrogation process before committing to a design, plan, or
strategy.
It is designed for architecture review, code review, Codex plugin and skill audits, business and product strategy, trading system evaluation, and general problem exploration.
Install
Register this repository as a Codex marketplace:
codex plugin marketplace add forsonny/deep-discovery
If that command fails on Windows with a Git staging-path error, use a local checkout:
git clone https://github.com/forsonny/deep-discovery.git
cd deep-discovery
codex plugin marketplace add .
Restart Codex, open Plugins, switch the filter to show third-party plugins, and
install deep-discovery from Deep Discovery Plugins.
For a local checkout, run this from the repository root:
codex plugin marketplace add .
To pick up repository updates later:
codex plugin marketplace upgrade deep-discovery-marketplace
Codex currently exposes marketplace management in the CLI. The final plugin install step happens in the Codex Plugins UI.
See docs/README.codex.md for the Codex-specific install and verification notes.
Usage
After installation, start a new Codex session and ask for Deep Discovery by name or by intent:
Run deep discovery on this architecture.
Stress test this plan with 100 questions.
Use deep-discovery to audit this Codex plugin before I publish it.
The skill routes to focused reference patterns for software architecture, code review, Codex plugin and skill creation, business and product strategy, trading and financial systems, or general analysis.
Contents
| Path | Purpose |
|---|---|
.codex-plugin/plugin.json | Codex plugin manifest and interface metadata |
.agents/plugins/marketplace.json | Repo marketplace manifest for Codex discovery |
skills/deep-discovery/SKILL.md | Main skill instructions |
skills/deep-discovery/references/ | Domain-specific question patterns |
docs/README.codex.md | Codex install and verification notes |
Validate
From the repository root:
python -m json.tool .codex-plugin\plugin.json
python -m json.tool .agents\plugins\marketplace.json
$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $HOME ".codex" }
$validator = Join-Path $codexHome "skills\.system\skill-creator\scripts\quick_validate.py"
python $validator skills\deep-discovery
The last command uses Codex's local skill-creator validator. If that validator
is not available, use Codex's current skill validation workflow.
License
MIT. See LICENSE.