https://github.com/michaelrocks/your-harness
https://github.com/michaelrocks/your-harness
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/michaelrocks/your-harness
- Owner: MichaelRocks
- Created: 2026-03-30T19:36:38.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-16T20:48:54.000Z (2 months ago)
- Last Synced: 2026-04-16T22:30:02.025Z (2 months ago)
- Language: Python
- Size: 67.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# your-harness
`your-harness` is a local Codex plugin that helps teams standardize a durable
engineering workflow around saved plans, behavior-first validation, root-cause
fixes, and long-lived docs.
It ships five skills:
- `create-harness`: bootstrap the harness into an empty repository from a short
product brief
- `adopt-harness`: add the harness to an existing repository without
overwriting existing files
- `plan-small-change`: clarify, plan, and implement a small approved
functionality change; implicit invocation allowed
- `plan-medium-change`: clarify, save a plan, and implement a medium approved
functionality change; implicit invocation allowed
- `plan-large-change`: clarify, save a phased plan set, and implement a large
approved functionality change phase by phase; implicit invocation allowed
## Repo Layout
- `.codex-plugin/plugin.json`: plugin manifest
- `skills/`: skill instructions and UI metadata
- `scripts/`: thin CLIs used by the skills
- `shared/`: shared Python implementation
- `assets/harness-template/`: canonical scaffold copied into user repositories
- `references/`: shared input defaults and conflict policy
## Local Use
This checkout includes repo-local marketplace metadata for `MichaelRocks
Plugins` at [`./.agents/plugins/marketplace.json`](./.agents/plugins/marketplace.json).
That entry points back to the repository root so the plugin can be tested from
this checkout.
To install the plugin into a local Codex home, run:
```bash
bash scripts/install_plugin.sh
```
The script copies the current repository into `~/.codex/plugins/your-harness`
without `.git` and common cache directories, then creates or updates
`~/.codex/plugins/marketplace.json` by replacing only the `your-harness` entry
from the repo-local marketplace file.
Skill helpers are simple Python CLIs:
```bash
python3 scripts/create_harness.py \
--target /path/to/empty-repo \
--project-name "Acme Radar" \
--product-description "Track product signals and incident risk." \
--primary-stacks backend,frontend \
--platforms web \
--ops-profile moderate \
--testing-posture behavior-first \
--emphasis-areas observability
```
```bash
python3 scripts/adopt_harness.py \
--target /path/to/existing-repo
```
Use `--apply` with `scripts/adopt_harness.py` to copy missing files after
reviewing the dry-run conflict report.
## Maintenance
- Update `assets/harness-template/` when the shipped scaffold changes.
- Keep skill instructions, shared references, and Python helpers aligned.
- Run `python3 -m unittest discover -s tests` after helper changes.
- Run the skill validator against each skill after editing `SKILL.md` or
`agents/openai.yaml`.