the-architect

Maintains cross-project architecture memory and governs architecture gates, assessments, and reusable components.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/coferlandia/coferlandia-skills --skill the-architect-coferlandia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: the-architect
Source: https://github.com/coferlandia/coferlandia-skills/tree/main/skills/engineering/the-architect
Command: npx skills add https://github.com/coferlandia/coferlandia-skills --skill the-architect-coferlandia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Architecture knowledge usually scatters across repositories, wikis, and chat threads, so teams repeat decisions, lose reusable-component evidence, and start risky initiatives without an architecture check. This Skill centralizes durable cross-project architecture memory in a portable Markdown/Obsidian home and enforces explicit Architecture Gates before implementation. ## Core Features & Use Cases - Architecture Preflight and Gates: Evaluate an Epic or plan before coding, write a bounded Architect Addendum, and set the gate to passed or blocked so downstream roles stop when required. - Evidence-Based Assessments: Run ATAM-lite assessments with quality scenarios, material risks, and concise briefs, recording only material deltas instead of repeating surveys. - Component Governance: Register reusable components, track their lifecycle from candidate to stable, and record project-by-project application results and extraction contracts. - Deterministic CLI: A Python CLI initializes the architecture home, creates validated records with stable IDs, rebuilds indexes, checks links, and enforces report word limits. - Use Case: Before starting a migration Epic, run the preflight workflow to check reusable components and material risks, then record the gate result; after release, run closeout to capture only the architectural delta. ## Quick Start Ask the agent to run an architecture preflight on your current Epic plan and initialize the architecture home using the bundled CLI.

Frequently Asked Questions about the-architect

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

FAQPage Schema
How do I run an architecture preflight before starting an Epic?▼

Add an Architecture Gate section to the plan, then activate the skill to inspect the repository read-only, load relevant architecture-home records, and write a bounded Architect Addendum. The gate is set to passed or blocked, and downstream roles must stop when it is not passed.

How do I set up the architecture home for the-architect?▼

Create a config.json at ~/.coferlandia/the-architect/ pointing to your home repository path, then run the CLI self-check and home init commands. The CLI creates dashboards, directories, and index files with dry-run preview support.

Does the-architect require Obsidian to work?▼

No, Markdown files remain authoritative and portable. Obsidian is optional and only used to navigate wikilinks between records; the CLI and all validation work on plain Markdown.

Can the-architect modify my source project or Git history?▼

No, assessments are read-only against source projects by default, and the CLI performs no Git commits, pushes, merges, or resets. Component extraction requires explicit current authority, and adopting an extracted component is a separate initiative.

When should I not use an Architecture Gate?▼

Skip the gate for routine localized features, ordinary bugs, Retouch Mode, stylistic refactors, and generic code review. Gates are intended for cross-cutting subsystems, shared contracts, migrations, security boundaries, and reusable component decisions.

What are the limitations of the architecture assessment reports?▼

Reports are deliberately concise: assessment briefs cap at 1,500 words with at most 3 critical risks and 5 important items. Depth lives in linked canonical records, and a valid outcome can be no material architectural change with no new records created.