# 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:

```powershell
codex plugin marketplace add forsonny/deep-discovery
```

If that command fails on Windows with a Git staging-path error, use a local
checkout:

```powershell
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:

```powershell
codex plugin marketplace add .
```

To pick up repository updates later:

```powershell
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](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:

```text
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:

```powershell
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](LICENSE).