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.