Onboard
Goal: read the codebase, produce living documentation. No code changes. No plans. No gap analysis.
living documentation
README.md : project overview, what it is, who it's for, how to use it.
docs/tech-spec.md : main technical specification (core backbone, ≤300 lines).
docs/specs/*.md : modular subsystem details split out when bulky (>15 lines). Referenced by path.
Technical specification is declarations only: current ground truth facts (atemporal, no narrative, no history, no plans).
Steps
- Explore entry points, public interfaces, key dependencies, test patterns, file structure. Read, don't guess.
- Ask the user about anything ambiguous — never invent architecture.
- Write
docs/tech-spec.md using the canonical format (field meanings: archive skill, "tech-spec format"):
purpose / user / use-case / architecture / stack / entry /
contract / flow / invariant / constraint / convention
- Omit
milestone — onboard makes no plans.
- Details >15 lines (schemas, algorithms, protocol states) go to
docs/specs/<topic>.md.
- Keep declarations atomic (≤25 words/sentence) with structured lists/tables; no text walls.
- Confirm with user.
docs/tech-spec.md must contain: stack + at least one contract + at least one convention (covering quality baseline — lint/format/typecheck tools, error-handling, security — read from code; see ../references/quality.md) before done.
Don't
- Invent facts not found in code or README.
- Add gap analysis, temporal/historical narratives, plans, or code changes.
- Paste large code blocks or schemas — reference by path or modularize into
docs/specs/.
After
docs/tech-spec.md on disk → user continues with normal design → plan → tdd.
1---2name: onboard-63description: Use when taking over an existing codebase that has no living document. Produces a factual record of what already exists.4metadata:5 source: https://skillmd.com/skills/hashgraph-online/onboard-66---78# Onboard910Goal: read the codebase, produce living documentation. No code changes. No plans. No gap analysis.1112## living documentation1314- `README.md` : project overview, what it is, who it's for, how to use it.15- `docs/tech-spec.md` : main technical specification (core backbone, ≤300 lines).16- `docs/specs/*.md` : modular subsystem details split out when bulky (>15 lines). Referenced by path.1718Technical specification is declarations only: current ground truth facts (atemporal, no narrative, no history, no plans).1920## Steps21221. **Explore** entry points, public interfaces, key dependencies, test patterns, file structure. Read, don't guess.232. **Ask the user** about anything ambiguous — never invent architecture.243. **Write** `docs/tech-spec.md` using the canonical format (field meanings: `archive` skill, "tech-spec format"):2526```27purpose / user / use-case / architecture / stack / entry /28contract / flow / invariant / constraint / convention29```3031 - Omit `milestone` — onboard makes no plans.32 - Details >15 lines (schemas, algorithms, protocol states) go to `docs/specs/<topic>.md`.33 - Keep declarations atomic (≤25 words/sentence) with structured lists/tables; no text walls.34354. **Confirm** with user.3637<gate>`docs/tech-spec.md` must contain: `stack` + at least one `contract` + at least one `convention` (covering quality baseline — lint/format/typecheck tools, error-handling, security — read from code; see `../references/quality.md`) before done.</gate>3839## Don't40- Invent facts not found in code or README.41- Add gap analysis, temporal/historical narratives, plans, or code changes.42- Paste large code blocks or schemas — reference by path or modularize into `docs/specs/`.4344## After45`docs/tech-spec.md` on disk → user continues with normal `design → plan → tdd`.