mine-arch

Creates and maintains a modular architecture knowledge base rooted at docs/design/index.md.

16|Updated Jul 23, 2026
One-click install
npx skills add https://github.com/6ixGODD/mine --skill mine-arch-6ixgodd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mine-arch
Source: https://github.com/6ixGODD/mine/tree/main/plugins/mine/skills/mine-arch
Command: npx skills add https://github.com/6ixGODD/mine --skill mine-arch-6ixgodd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Software architecture knowledge often lives only in chat sessions or a single stale document, so design decisions, quality gates, and repository conventions drift out of sync with the actual codebase across sessions and agents. ## Core Features & Use Cases - Architecture knowledge base: Builds a progressive-disclosure design tree under docs/design/ with domain indexes and leaf contracts, separating current reality, target architecture, and open decisions. - Repository governance and quality gates: Creates or repairs AGENTS.md plus formatter, linter, type-checker, test, and CI configuration matched to the actual languages in the repository. - ADR-gated decisions and MINE integration: Routes material decisions through digest-bound ADR approval and initializes the MINE execution graph via the mine CLI or MCP tools. - Use Case: When starting a new project or rescuing a repository with stale architecture docs, run this Skill to audit the code, research official documentation, and produce a validated design knowledge base with working quality gates. ## Quick Start Ask the agent to use mine-arch to design the target architecture for this repository and initialize its design knowledge base and quality gates.

Frequently Asked Questions about mine-arch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an architecture document for a new repository?

Run mine-arch to audit the repository and requirements, research official documentation for external dependencies, and generate a progressive-disclosure design knowledge base rooted at docs/design/index.md. It also initializes AGENTS.md and language-appropriate quality gates.

What is the difference between mine-arch and mine-sync?

mine-arch is requirement-first: it designs the target architecture from user requirements and may intentionally differ from current code. mine-sync is code-first: it synchronizes the design against the repository's actual implementation.

Does mine-arch modify business code or create execution plans?

No. mine-arch writes only to MINE-owned design files, AGENTS.md, quality-gate configuration, and the design ownership marker. Implementation belongs to mine-plan-exec, and plan creation is an explicit handoff to mine-plan-create.

Which languages and quality tools does mine-arch configure?

It supports Python (Ruff, Mypy, pytest), Go (gofmt, go vet, staticcheck), TypeScript/JavaScript (ESLint, Prettier, tsconfig), and Rust (rustfmt, Clippy), selecting only tools matching the repository's actual languages and package managers.

Why does mine-arch stop for ADR approval before planning?

Material decisions must pass a digest-bound ADR lifecycle: propose, show, and explicit owner approval. mine-arch never self-approves ADRs or continues planning while a planning-blocking ADR is unresolved, ensuring decisions are traceable.

What happens if the mine CLI or web search is unavailable?

Architecture work proceeds but graph initialization is reported as blocked with the installation command. If web research is unavailable, the skill reports the blocker and does not claim the architecture or toolchain setup is complete.