Agent skill

Architect

by TheBeardedBearSAS in TheBeardedBearSAS/claude-craft

Phase d'architecture systématique AVANT le code (TDD). An agent skill from TheBeardedBearSAS/claude-craft.

MITAuto-check passedTesting & QA

Install Architect

skills CLI

$ npx skills add TheBeardedBearSAS/claude-craft --skill architect -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install TheBeardedBearSAS/claude-craft architect --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/TheBeardedBearSAS/claude-craft.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/architect .claude/skills/architect && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "architect" agent skill from https://github.com/TheBeardedBearSAS/claude-craft/tree/main/.claude/skills/architect into .claude/skills/architect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "architect", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/TheBeardedBearSAS/claude-craft/tree/main/.claude/skills/architect

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add TheBeardedBearSAS/claude-craft --skill architect -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install TheBeardedBearSAS/claude-craft architect --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/TheBeardedBearSAS/claude-craft.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/architect .agents/skills/architect && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "architect" agent skill from https://github.com/TheBeardedBearSAS/claude-craft/tree/main/.claude/skills/architect into .agents/skills/architect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "architect", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add TheBeardedBearSAS/claude-craft --skill architect -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install TheBeardedBearSAS/claude-craft architect --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/TheBeardedBearSAS/claude-craft.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/architect .cursor/skills/architect && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "architect" agent skill from https://github.com/TheBeardedBearSAS/claude-craft/tree/main/.claude/skills/architect into .cursor/skills/architect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "architect", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/TheBeardedBearSAS/claude-craft.git --path .claude/skills/architect

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add TheBeardedBearSAS/claude-craft --skill architect -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install TheBeardedBearSAS/claude-craft architect --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/TheBeardedBearSAS/claude-craft.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/architect .gemini/skills/architect && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "architect" agent skill from https://github.com/TheBeardedBearSAS/claude-craft/tree/main/.claude/skills/architect into .gemini/skills/architect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "architect", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install TheBeardedBearSAS/claude-craft architect

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add TheBeardedBearSAS/claude-craft --skill architect -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/TheBeardedBearSAS/claude-craft.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/architect .github/skills/architect && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "architect" agent skill from https://github.com/TheBeardedBearSAS/claude-craft/tree/main/.claude/skills/architect into .github/skills/architect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "architect", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add TheBeardedBearSAS/claude-craft --skill architect -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install TheBeardedBearSAS/claude-craft architect --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/TheBeardedBearSAS/claude-craft.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/architect .opencode/skills/architect && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "architect" agent skill from https://github.com/TheBeardedBearSAS/claude-craft/tree/main/.claude/skills/architect into .opencode/skills/architect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "architect", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: architect
GitHub stars: 107
Token cost: ~1.2k tokens
SKILL.md length: 466 words
Files: 1
Skills in repo: 12
Repo updated: Sep 14, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Phase d'architecture systématique AVANT le code (TDD). An agent skill from TheBeardedBearSAS/claude-craft.

Works in 5 steps: Identifier les boundaries → Définir les contrats → Dessiner les dépendances → …
Starting a new feature that touches multiple files
SKILL.md covers Quand utiliser, Processus en 5 étapes, Livrables and Anti-patterns, plus 2 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Architect is an agent skill from TheBeardedBearSAS/claude-craft. Phase d'architecture systématique AVANT le code (TDD). Use when starting a new feature that touches multiple files, designing a new module, or making non-trivial architectural choices.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering Test-driven development. The repository describes itself as: Supercharge Claude Code with Expert Knowledge A comprehensive framework for AI-assisted development. Install standardized rules, agents, and commands for your projects across… The licence is MIT.

When your agent uses it

Starting a new feature that touches multiple files
Designing a new module
Making non-trivial architectural choices

Example prompts

“/architect”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

Identifier les boundaries
Définir les contrats
Dessiner les dépendances
Lister les trade-offs
Définir les tests d'architecture

What it can do on your machine

Read from SKILL.md and the folder at commit 99c1ee3. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- github.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Architect loads about 1.2k tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 466 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~49
When it runs · the whole SKILL.md, loaded when a task matches: ~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from TheBeardedBearSAS/claude-craft at commit 99c1ee3, republished under its MIT licence (© TheBeardedBearSAS). 466 words, ~1,184 tokens.

Download SKILL.mdSave it as .claude/skills/architect/SKILL.md (or your agent's skills folder).

name: architect
description: Phase d'architecture systématique AVANT le code (TDD). Use when starting a new feature that touches multiple files, designing a new module, or making non-trivial architectural choices.
context: fork

Architect — Phase d'architecture avant TDD

Skill inspiré de obra/superpowers. Objectif : produire une spec d'architecture avant d'écrire le moindre test ou ligne de code.

Règle d'or : si tu ne peux pas dessiner le diagramme, tu ne peux pas coder la feature.

Quand utiliser

Situation	Architect phase ?
Bug 1 fichier	❌ Non (go direct TDD)
Nouvelle feature < 3 fichiers	⚠️ Court (10 min)
Nouvelle feature > 3 fichiers	✅ Obligatoire
Nouveau module/bounded context	✅ Obligatoire
Migration technique	✅ Obligatoire
Intégration externe (API, MQ, DB)	✅ Obligatoire

Processus en 5 étapes

1. Identifier les boundaries

Quelles frontières la feature touche-t-elle ?

Domain boundaries — quels bounded contexts impliqués ?
Layer boundaries — Presentation / Application / Domain / Infrastructure ?
Process boundaries — sync HTTP / async queue / event-driven ?
Data boundaries — quelles bases de données, quelles tables ?
Ownership boundaries — quelle équipe owne quel morceau ?

Output : liste des frontières traversées.

2. Définir les contrats

Pour chaque frontière traversée, définir le contrat :

Inputs : format, types, invariants, nullabilité
Outputs : format, codes d'erreur, latence cible
Side effects : écritures DB, events émis, appels externes
Idempotence : le contrat est-il idempotent ?
Transactions : atomique ? eventually consistent ?

Output : signatures de fonctions/endpoints + DTO.

3. Dessiner les dépendances

Qui dépend de quoi ? Dans quel sens ?

[HTTP Controller] ──▶ [Use Case] ──▶ [Domain Service]
                                          │
                                          ▼
                                     [Repository] (interface)
                                          │
                                          ▼
                        [Postgres Adapter] ─implements─▶

Vérifier :

Pas de cycle (A → B → A)
DIP respecté (domain ne dépend pas de l'infra)
Pas plus de 3 niveaux d'appel entre entrée et côté métier

Output : diagramme (Mermaid, ASCII, ou texte structuré).

4. Lister les trade-offs

Pour chaque décision non évidente, documenter pourquoi ce choix :

Décision	Alternative envisagée	Pourquoi ce choix
Async via queue	Sync HTTP	Latence >500ms, pas critique immédiat
CQRS	CRUD simple	Ratio 20:1 lecture/écriture
Event sourcing	Store état	Besoin audit légal

Output : ADR léger (3-5 bullets) — voir .claude/rules/10-documentation.md pour ADR formel si décision majeure.

Show full SKILL.md (194 more words)Show less

5. Définir les tests d'architecture

Avant TDD sur le comportement, définir les tests d'architecture :

Tests de dépendances (ArchUnit, Dephpend, deptrac)
Tests de contrats (OpenAPI validation, contract tests)
Tests de performance cibles (latence p99, throughput)
Tests d'isolation multitenant si applicable

Output : liste de tests d'architecture à écrire en Phase TDD.

Livrables

À la fin de la phase Architect, produire :

Diagramme dépendances (1 page max)
Contrats des frontières (signatures + DTO)
ADR court trade-offs principaux
Liste de tests d'architecture
Découpage en tâches atomiques (voir skill atomic-tasks)

Ce n'est qu'après qu'on rentre dans le TDD (Red/Green/Refactor).

Anti-patterns

Anti-pattern	Solution
Coder directement sans diagramme	Dessiner AVANT, même 5 min suffisent
Architect phase > 2h sur feature simple	YAGNI — couper court
Contrats flous ("objet User")	Types stricts, tous les champs
Ignorer les trade-offs	ADR court obligatoire
Architecture en vase clos	Review par un pair ou subagent `@tech-lead`

Intégration Claude Craft

/workflow:design — utilise ce skill par défaut
Agent @tech-lead — peut produire l'output Architect
ADR formel : voir /common:architecture-decision
Rule 04 SOLID + Rule 17 CQRS + Rule 14 Multitenant — consulter selon contexte

Ressources

obra/superpowers
Rule .claude/rules/04-solid-principles.md
Rule .claude/rules/10-documentation.md (ADR)
Skill atomic-tasks

Date de dernière mise à jour : 2026-04-15 Version : 1.0.0

Files

Just SKILL.md in .claude/skills/architect of TheBeardedBearSAS/claude-craft.

Open the folder on GitHubat commit 99c1ee3

Compare with similar skills

Architect next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Architect compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Architect this skillTheBeardedBearSAS/claude-craft	107	—	~1.2k	Automated safety check: Pass	MIT	24 days ago
TDDpietheinstrengholt/rssmonster	564	30 repos	~906	Automated safety check: Pass	MIT	yesterday
TDD WorkflowhellangleZ/burn-in-cceverywhere-ralph	112	11 repos	~2.4k	Automated safety check: Pass	None	8 mo ago
TDDsanity-io/sanity	6.4k	20 repos	~1k	Automated safety check: Pass	MIT	today
Test Driven Developmentfarm-fe/farm	5.6k	51 repos	~2.5k	Automated safety check: Pass	MIT	17 days ago
Tapd Story PipelineTencentBlueKing/bk-bcs	841	—	~2.6k	Automated safety check: Pass	Custom licence	yesterday

Similar skills

TDD
pietheinstrengholt/rssmonster
Test-driven development. An agent skill from pietheinstrengholt/rssmonster.
564 GitHub starsUsed in 30 repos~906 tokens
Testing & QAAuto-check passed
TDD Workflow
hellangleZ/burn-in-cceverywhere-ralph
A skill your agent uses when writing new features, fixing bugs, or refactoring code.
112 GitHub starsUsed in 11 repos~2.4k tokens
Testing & QAAuto-check passed
TDD
sanity-io/sanity
Official
Test-driven development with red-green-refactor loop. An agent skill from sanity-io/sanity.
6.4k GitHub starsUsed in 20 repos~1k tokens
Testing & QAAuto-check passed
Test Driven Development
farm-fe/farm
A skill your agent uses when implementing any feature or bugfix, before writing implementation code
5.6k GitHub starsUsed in 51 repos~2.5k tokens
Testing & QAAuto-check passed
Tapd Story Pipeline
TencentBlueKing/bk-bcs
单需求实现流水线——把一个 TAPD 需求从零推进到代码提交。自动串联技术澄清、开发计划、任务拆分、TDD 实现、架构/安全校验、代码提交六个阶段。
841 GitHub stars~2.6k tokensUpdated yesterday
Testing & QAAuto-check passed
Absolute Init
maddhruv/absolute
One-time setup for absolute: interview how you want it to behave (output style, autonomy, TDD strictness, spec dir, families) + detect the stack once, then write .absolute.config.json (project…
218 GitHub starsUsed in 1 repo~3k tokens
Testing & QAAuto-check passed

Questions about Architect

What does Architect do?

Phase d'architecture systématique AVANT le code (TDD). An agent skill from TheBeardedBearSAS/claude-craft. Architect is an agent skill from TheBeardedBearSAS/claude-craft. Phase d'architecture systématique AVANT le code (TDD).

When should I use Architect?

Architect fits situations like: starting a new feature that touches multiple files; designing a new module; making non-trivial architectural choices.

How do I install Architect in Claude Code?

Run `npx skills add TheBeardedBearSAS/claude-craft --skill architect -a claude-code`. Or copy the skill folder (.claude/skills/architect in TheBeardedBearSAS/claude-craft) into .claude/skills/architect in your project. Claude Code loads it when a task matches its description.

How do I install Architect in Codex?

Run `npx skills add TheBeardedBearSAS/claude-craft --skill architect -a codex`. Or copy the skill folder (.claude/skills/architect in TheBeardedBearSAS/claude-craft) into .agents/skills/architect in your project. Codex loads it when a task matches its description.

Can I use Architect in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add TheBeardedBearSAS/claude-craft --skill architect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/architect, .gemini/skills/architect, .github/skills/architect and .opencode/skills/architect in your project.

What does Architect need to run?

SKILL.md names no scripts, command-line tools or credentials: Architect is instructions for the agent only.

Does Architect access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Architect safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Architect use?

Architect is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Architect use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Architect?

Skills that share tags, products or a category with Architect: TDD (pietheinstrengholt/rssmonster, 564 stars), TDD Workflow (hellangleZ/burn-in-cceverywhere-ralph, 112 stars), TDD (sanity-io/sanity, 6.4k stars) and Test Driven Development (farm-fe/farm, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architect?

TheBeardedBearSAS (a GitHub organization) maintains it in TheBeardedBearSAS/claude-craft, which has 107 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on September 14, 2026.

Source: TheBeardedBearSAS/claude-craft on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Architect

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Architect — Phase d'architecture avant TDD

Quand utiliser

Processus en 5 étapes

1. Identifier les boundaries

2. Définir les contrats

3. Dessiner les dépendances

4. Lister les trade-offs

5. Définir les tests d'architecture

Livrables

Anti-patterns

Intégration Claude Craft

Ressources

Files

Compare with similar skills

Similar skills

More from TheBeardedBearSAS/claude-craft

Related

Questions about Architect