This repository is a source-grounded research workspace for studying agentic coding harnesses, extracting reusable implementation knowledge, and publishing that knowledge as a reader-facing book.
| Path | Role |
|---|---|
harnesses/ |
Pinned source repositories and artifacts. This is the primary evidence and source of truth. |
harnesses_overview/ |
Technical reports, feature maps, comparisons, and implementation adaptations derived from the sources. |
harness-book/ |
The reader-facing Mintlify book generated from the overview material. |
skills/ |
Local Codex skills used to produce consistent reports and cross-harness syntheses. |
The intended research flow is:
harnesses/ -> harnesses_overview/ -> harness-book/
Start with the source registry for upstream repositories and pinned revisions, then use the overview index to find reports by harness or topic.
- Verify important claims against code, prompts, schemas, tests, configuration,
and documentation under
harnesses/. - Treat
harnesses_overview/as derived knowledge, not as primary proof. - Preserve upstream identifiers exactly, including command names, tool IDs, functions, classes, schema fields, and file names.
- Cite repository-relative source paths and distinguish code-backed claims from documentation-backed or artifact-backed claims.
- Update overview knowledge before changing the corresponding book chapter.
Install the Mintlify CLI, then run:
cd harness-book
mint devValidate the book before publishing changes:
cd harness-book
mint validate
mint broken-linksThe book configuration is in
harness-book/docs.json.
Keep source code and imported artifacts in harnesses/. Add explanatory
reports to harnesses_overview/, keep its index current, and propagate
reader-facing updates to harness-book/ only after the underlying report is
present or corrected.
This repository is licensed under the MIT License.