mine-arch

MINE Architecture

Create or update the repository architecture and make the repository capable of enforcing it.

MINE Is Not Everyone's. This skill is not limited to writing prose. It owns:

• architecture discovery and design;
• the modular, progressive-disclosure design knowledge base rooted at docs/design/index.md;
• repository-wide engineering agreements in AGENTS.md;
• selection and initialization of language-appropriate quality gates;
• creation or repair of missing formatter, linter, type-checker, test, build, pre-commit, and CI configuration;
• validation that the documented commands actually run.

mine-arch is requirement-first (governed by docs/design/integrations/skills.md and docs/design/governance/design-knowledge-base.md). It designs target architecture from user requirements and may intentionally differ from current code; it must not silently treat current code as the target architecture when the user's requirement changes that target. This makes it the requirement-first counterpart to mine-sync, which is code-first by intent.

Fixed outputs (the MINE design knowledge base)

MINE owns docs/design/ (ADR-0006). The design tree is a progressive-disclosure knowledge base, not a single manuscript:

docs/design/
  .mine-design.toml       # ownership marker (schema_version, managed_by=MINE, repository_id, created_at)
  index.md                # root index, links to domain indexes
  <domain>/
    index.md
    <component>/
      index.md
      <leaf>.md           # exact contracts live here

• The root index is docs/design/index.md; every design area owns an index.md.
• Root index links to domain indexes; domain indexes link to component indexes; leaves contain exact contracts.
• One contract has one authoritative leaf; an index may summarize a child in one or two sentences but does not duplicate its full contract.
• Do not create a competing single-document architecture source, and do not rename docs/design/index.md to something else or introduce a competing architecture-and-detailed-design.md file.