# Documentation Index

Documentation for the `stackone-agent-harness` plugin — the gated three-phase connector
flow (Research → Build → Validate). Start with the top-level [README](../README.md) for
the overview, install steps, and gate philosophy.

## Phase references

- [phases/README.md](phases/README.md) — the three-phase flow at a glance
- [phases/1-research.md](phases/1-research.md) — Phase 1: research & investigation
- [phases/2-build.md](phases/2-build.md) — Phase 2: build the connector
- [phases/3-validation.md](phases/3-validation.md) — Phase 3: validation & benchmarking

## Conventions and contracts

- [PATHS.md](PATHS.md) — canonical path conventions: every file the plugin reads,
  writes, or references, including the `run.json` state contract and the
  `connector_path` rule
- [../scripts/README.md](../scripts/README.md) — script catalog: the five gates, the
  state CLIs, and the research helpers

## Maintainer notes

- [maintenance/plugin-layout.md](maintenance/plugin-layout.md) — where everything lives:
  directory layout and placement conventions
- [maintenance/development-lifecycle.md](maintenance/development-lifecycle.md) — how a
  change moves: verify, PR, benchmark, review, merge, and out to a connector builder