ark-adopt

/ark-adopt — Mark the path (session 0)

Contener · Guiar · Ordenar. In plain words: contain the write, guide the next step, order leftover mess. This door is Contener: write the path so the tree has honest houses. Skills never enforce — CLI / hooks / CI do.

When: empty tree, or the rules file does not match the real folders (session 0). Not when: a single new file (/ark-place) or leftover design after the path is honest (/ark-explore then /ark-autopilot).

Steps

1. Read arkgate-check --doctor (one light, one next action).
2. Write ark.config.json (and a baseline only for genuine debt) in this turn.
3. Re-run doctor. Day-to-day new files: /ark-place.

Checklist

• Existing tree: propose SharedKernel (types/constants) + CompositionRoot (wiring) + src/**/domain/**. Never dump bare src/lib/** into Application.
• Every include path must land in a layer. Include that classifies no file is the same as an empty check — not a pass. Fix globs here; do not leave a loose gap.
• Generate .ark/golden-pattern.json (load-bearing for /ark-place).
• Future houses: mark unused layer globs reserved / allowEmpty so --strict-config does not fail.
• When the product map or glossary names a house, write layers[].description as app-context copy (what this folder is in the product). Compact starter may omit. Do not invent captions. Do not invent /ark-describe.
• When the product map names who a folder is for, write layers[].trustBoundary (public | auth | admin | internal). Compact starter may omit. Do not invent tags. Absence is silent. No /ark-trust.
• When the product map names who owns a folder, write layers[].owners (GitHub handle or email). Compact starter may omit. Do not invent people. Absence is silent unless the user asked for required owners — then write requireLayerOwners: true after the live houses have names. No /ark-owners.
• When a layer exposes a deliberate public barrel or facade (e.g. src/domain/index.ts), optional layers[].entrypoints restricts cross-layer imports into that layer to matching globs. Intra-layer imports stay unrestricted. Absence is silent. No /ark-entrypoints.
• On brownfield trees with genuine pre-existing debt, ark init --baseline (or arkgate-check --write-baseline) freezes .ark-baseline.json so --strict-merge blocks only new regressions.
• When the user wants required gates (--require-gates / --strict-merge / required GitHub check) and there is no docs/adr/ (or docs/decisions/), leave a short decision note there — only if they loosen a rule or add a real gate. Not every change. Doctor residual is soft. No /ark-adr.
• When a product-domain doc is already in play (docs/domain.md or a sibling) and doctor JSON has statesTransitions or statusTransitionCatalog, add a short states → transitions table (or one link) there. Use catalog names when present. No flag soup. Soft residual. Silent when that doc is absent or Domain has no status vocabulary. No /ark-states.
• When doctor JSON has noDomainFrontend, keep the empty Domain house — do not delete it to “clean” empty layers. Next is one Domain file (/ark-place), not a weaker contract. Soft. Silent when there is no frontend or Domain already has files. No /ark-domain.
• When doctor JSON has prototypeShortcuts, keep the Persistence / Domain house — do not delete it to “clean” empty layers. Next is one Persistence adapter or Domain policy file (/ark-place), not a weaker contract. Soft. Silent when those houses are absent or the shortcut is already in the right house. No /ark-prototype.
• When the tree is adopted and doctor JSON has invariantTestsPath (or the check names INVARIANT_TESTS_PATH_MISSING), write coverage.testGlobs or coverage.coverageRoots to a real tests folder. Fail-closed until that path exists. Silent when not adopted, the catalog is empty, or every invariant sets coverage.test false. No new skill.
• When any invariant is enforced and doctor JSON has invariantCoverageRoots (or the check names INVARIANT_COVERAGE_ROOTS_MISSING), write coverage.coverageRoots to the folder the test runner uses. Fail-closed until that path exists. coverage.testGlobs alone is not enough. Silent when no invariant is enforced. No new skill.
• coverage.symbol means a declaration of that identifier in a non-test file. Doctor and --rules-inventory print symbolEvidenceFile and the discard counts even when uncovered is 0. Read that path. Imports and calls in tests do not count. That declaration text is not “the tests pass” — ArkGate never runs tests. No new config key.
• CLI-first: if arkgate-check already resolved the root, do not wait on MCP.
• Do not add arkRun or arkOrder unless the user wants that extra. When they do, write advisory extra in this turn (arkRun schema 1.2+; arkOrder schema 1.3+). Absence is silent and valid. Compact starter stays extras-off. Skills never enforce.