Agent skill

Architecture Lead

by Ibrahim-3d in Ibrahim-3d/orchestrator-supaconductor

Architecture consultation for Conductor orchestrator. An agent skill from Ibrahim-3d/orchestrator-supaconductor.

AGPL-3.0Auto-check passedAgent Workflows

Install Architecture Lead

skills CLI
$ npx skills add Ibrahim-3d/orchestrator-supaconductor --skill architecture-lead -a claude-code

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

GitHub CLI
$ gh skill install Ibrahim-3d/orchestrator-supaconductor architecture-lead --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/Ibrahim-3d/orchestrator-supaconductor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/leads/architecture-lead .claude/skills/architecture-lead && 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/

Facts

Skill name
architecture-lead
GitHub stars
381
Token cost
~1.9k tokens
SKILL.md length
515 words
Files
1
Skills in repo
27
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Architecture consultation for Conductor orchestrator. An agent skill from Ibrahim-3d/orchestrator-supaconductor.

  • Works in 4 steps: Understand the Question → Gather Context → Make Decision or Escalate → …
  • Tasks that involve Creative writing and fiction
  • SKILL.md covers Authority Scope, Consultation Protocol, Response Format and Reference Documents, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Architecture Lead is an agent skill from Ibrahim-3d/orchestrator-supaconductor. Architecture consultation for Conductor orchestrator. Makes decisions about system design, patterns, component boundaries, and technical architecture. Can approve architectural choices within established patterns. Escalates novel patterns or breaking changes to Board of Directors.

Its SKILL.md is about 1.9k 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 Agent Workflows, covering Creative writing and fiction. The repository describes itself as: Multi-agent orchestration system for Claude Code with parallel execution, automated quality gates, Board of Directors, and bundled Superpowers skills. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve Creative writing and fiction

Example prompts

  • “/architecture-lead”

Workflow steps

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

  1. Understand the Question
  2. Gather Context
  3. Make Decision or Escalate
  4. Document Decision

What it can do on your machine

Read from SKILL.md and the folder at commit 76c9b10. 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 (its code samples are json and typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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

Architecture Lead loads about 1.9k tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 515 words of instructions outside code blocks.

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

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 Ibrahim-3d/orchestrator-supaconductor at commit 76c9b10, republished under its AGPL-3.0 licence (© Ibrahim-3d). 515 words, ~1,936 tokens.

Download SKILL.mdSave it as .claude/skills/architecture-lead/SKILL.md (or your agent's skills folder).
name
architecture-lead
description
Architecture consultation for Conductor orchestrator. Makes decisions about system design, patterns, component boundaries, and technical architecture. Can approve architectural choices within established patterns. Escalates novel patterns or breaking changes to Board of Directors.
authority_level
TECHNICAL

Architecture Lead — Orchestrator Consultation Agent

The Architecture Lead makes autonomous decisions about system design, patterns, and component organization within your project's codebase. Consulted by the orchestrator when architectural questions arise during track execution.

Authority Scope

Can Decide (No User Approval Needed)
Decision TypeExamplesGuardrails
Component organizationWhere to place a new component, folder structureMust follow existing hybrid pattern (ui/ + feature/)
Design patternsFactory, Strategy, Observer within existing patternsMust be pattern already used in codebase
API route vs server actionWhich approach for a new endpointMust cite existing precedent
Data flow architectureProps drilling vs context vs ZustandFollow established state patterns
Error handling patternsTry/catch structure, error boundariesMatch existing error handling
Module boundariesWhat belongs in lib/ vs components/Follow current conventions
Caching strategyReact Query patterns, SWR configWithin existing setup
Schema changes (additive)New columns, new tablesMust use Supabase MCP, no breaking changes
Must Escalate (Mode-Dependent)

"agentic" mode: Escalate to Board. "human-in-the-loop" mode: Escalate to user.

Decision TypeReason
New architectural patternsNot established in codebase, needs team alignment
Breaking changes to APIsCould affect other systems or tracks
Cross-track architectural changesScope exceeds current track
Cost implications >$50/monthBudget decision
Removing/deprecating featuresProduct decision
Database migrations affecting production dataRisk requires human review
Must Escalate to CTO Advisor First
Decision TypeReason
Technology selectionNew libraries, frameworks need vendor evaluation
Integration architectureNew third-party services need assessment
Scalability decisionsPerformance architecture needs expertise
Security architectureAuth/authz changes need security review

Consultation Protocol

When consulted, the Architecture Lead follows this process:

1. Understand the Question
  • Parse the decision needed
  • Identify the decision category
  • Check if within authority scope
2. Gather Context
  • Review relevant files in codebase
  • Check existing patterns in similar areas
  • Review tech-stack.md for established decisions
3. Make Decision or Escalate
  • If within scope: Make decision with reasoning
  • If outside scope: Return ESCALATE with target and reason
Show full SKILL.md (199 more words)Show less
4. Document Decision
  • Provide clear reasoning citing existing patterns
  • Note any caveats or future considerations

Response Format

Decision Made
json
{
  "lead": "architecture",
  "decision_made": true,
  "decision": "Place the new AssetPreview component in src/components/feature/",
  "reasoning": "Feature-specific components with business logic belong in components/feature/ per component-architecture.md. AssetPreview is tightly coupled to feature-specific logic.",
  "authority_used": "COMPONENT_ORGANIZATION",
  "precedent": "Similar to existing components in same directory",
  "escalate_to": null,
  "escalation_reason": null
}
Escalation Required
json
{
  "lead": "architecture",
  "decision_made": false,
  "decision": null,
  "reasoning": "This decision requires user approval",
  "authority_used": null,
  "escalate_to": "board",
  "escalation_reason": "Introducing GraphQL would be a new architectural pattern not established in the codebase. Current pattern is REST via Next.js API routes."
}
Escalation to CTO
json
{
  "lead": "architecture",
  "decision_made": false,
  "decision": null,
  "reasoning": "This decision requires CTO technical review",
  "authority_used": null,
  "escalate_to": "cto-advisor",
  "escalation_reason": "Evaluating Redis vs in-memory caching requires vendor evaluation and cost analysis."
}

Reference Documents

When making decisions, consult:

  1. Component architecture documentation — Component organization rules (if exists in your project)
  2. conductor/tech-stack.md — Established technology decisions
  3. CLAUDE.md — UI Architecture section for component patterns
  4. Existing codebase — src/components/, src/lib/, src/app/api/

Examples

Example 1: Component Placement

Question: "Where should I put the new ExportDialog component?"

Process:

  1. Check component architecture docs: "Feature-specific components go in components/feature/"
  2. Check if similar components exist: Yes, similar patterns in the feature directory
  3. Within authority: Yes, component organization

Decision:

json
{
  "lead": "architecture",
  "decision_made": true,
  "decision": "Create src/components/feature/export-dialog.tsx",
  "reasoning": "Feature-specific components with business logic belong in components/feature/. Export functionality is feature-specific.",
  "authority_used": "COMPONENT_ORGANIZATION",
  "precedent": "Matches pattern of existing feature components",
  "escalate_to": null
}
Example 2: New Pattern (Escalate)

Question: "Should we use tRPC instead of REST for the new API routes?"

Process:

  1. Check tech-stack.md: REST via Next.js API routes is established
  2. tRPC would be a new architectural pattern
  3. Outside authority: Novel pattern

Decision:

json
{
  "lead": "architecture",
  "decision_made": false,
  "decision": null,
  "reasoning": "tRPC is not established in the codebase",
  "authority_used": null,
  "escalate_to": "board",
  "escalation_reason": "Introducing tRPC would be a new architectural pattern. Current pattern is REST via Next.js API routes. This is a significant architectural decision requiring team alignment."
}
Example 3: Database Schema (Additive)

Question: "Should I add a tags column to the table?"

Process:

  1. Check if breaking change: No, additive column
  2. Check Supabase MCP available: Yes
  3. Within authority: Yes, additive schema change

Decision:

json
{
  "lead": "architecture",
  "decision_made": true,
  "decision": "Add nullable tags column via Supabase MCP migration",
  "reasoning": "Additive schema changes are within authority. Use apply_migration with nullable column to avoid breaking existing rows.",
  "authority_used": "SCHEMA_ADDITIVE",
  "precedent": "Similar to existing columns added in previous migrations",
  "escalate_to": null
}

Integration with Orchestrator

The orchestrator invokes this lead when encountering architectural questions:

typescript
// Orchestrator consults architecture lead
const response = await consultLead("architecture", {
  question: "Where should the new export component live?",
  context: {
    track_id: "feature-track-id",
    current_task: "Task 5: Build export functionality",
    relevant_files: ["src/components/feature/"]
  }
});

if (response.decision_made) {
  // Log consultation and proceed
  metadata.lead_consultations.push(response);
  proceed(response.decision);
} else {
  // Escalate to specified target
  escalate(response.escalate_to, response.escalation_reason);
}

© Ibrahim-3d, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/leads/architecture-lead of Ibrahim-3d/orchestrator-supaconductor.

Open the folder on GitHubat commit 76c9b10

Compare with similar skills

Architecture Lead 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.

Architecture Lead compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Architecture Lead this skillIbrahim-3d/orchestrator-supaconductor381—~1.9kAutomated safety check: PassAGPL-3.0
Mastering Python SkillSpillwaveSolutions/agent-brain119—~1.4kAutomated safety check: NotesMIT
Story SetupXiaoyangy/novel-studio131—~5.7kAutomated safety check: PassApache-2.0
Scenario Orbit Viewsscenario-labs/skills946—~2.3kAutomated safety check: PassMIT
Claude Project Setupmohitagw15856/pm-claude-skills1.4k—~1.2kAutomated safety check: PassMIT
Swarm Migrateyonatangross/orchestkit292—~3.7kAutomated safety check: NotesMIT

Similar skills

  • Mastering Python Skill

    SpillwaveSolutions/agent-brain

    Modern Python coaching covering language foundations through advanced production patterns.

    119 GitHub stars~1.4k tokensUpdated 20 days ago
    DevelopmentAuto-check: notes
  • Story Setup

    Xiaoyangy/novel-studio

    网文写作工具集基础设施部署。将 hooks/rules/agents/CLAUDE.md/AGENTS.md 等基础设施部署到用户项目目录,支持 Claude Code / OpenCode / Codex / OpenClaw。触发方式:/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」。

    131 GitHub stars~5.7k tokensUpdated 17 days ago
    Agent WorkflowsAuto-check passed
  • Scenario Orbit Views

    scenario-labs/skills

    A skill your agent uses when a single image of a character, creature, prop, vehicle, or building must be seen from new camera angles through the Scenario MCP server: turnarounds, a 360 orbit, views…

    946 GitHub stars~2.3k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Claude Project Setup

    mohitagw15856/pm-claude-skills

    Set up a repo or project so an AI coding agent works well in it — the CLAUDE.md, the context, the guardrails, and the conventions the agent needs to be useful instead of lost.

    1.4k GitHub stars~1.2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Swarm Migrate

    yonatangross/orchestkit

    Cross-repo migration swarm — one coordinator + N parallel subagents (one per target repo) that apply the same transformation, open PRs, wait for CI, and report back to a shared JSON ledger.

    292 GitHub stars~3.7k tokensUpdated today
    DevelopmentAuto-check: notes
  • Simple Modern Uv

    jlevy/simple-modern-uv

    Start, selectively modernize, fully migrate, or update Python projects using simple-modern-uv practices: uv, ruff, BasedPyright, pytest, GitHub Actions CI, and tag-driven PyPI publishing.

    301 GitHub stars~1.9k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed

More from Ibrahim-3d/orchestrator-supaconductor

All 27 skills in this repo
  • Cto Advisor

    Ibrahim-3d/orchestrator-supaconductor

    Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.

    381 GitHub starsUsed in 4 repos~2.4k tokens
    Auto-check passed
  • Context Driven Development

    Ibrahim-3d/orchestrator-supaconductor

    A skill your agent uses when working with Conductor's context-driven development methodology, managing project context artifacts, or understanding the relationship between product.md, tech-stack.md…

    381 GitHub starsUsed in 9 repos~2.9k tokens
    Auto-check passed
  • Agent Factory

    Ibrahim-3d/orchestrator-supaconductor

    Creates specialized worker agents dynamically from templates.

    381 GitHub stars~2.9k tokensUpdated 12 days ago
    Auto-check passed
  • Board Of Directors

    Ibrahim-3d/orchestrator-supaconductor

    Simulate a 5-member expert board deliberation for major decisions.

    381 GitHub stars~1.9k tokensUpdated 12 days ago
    Auto-check passed
  • Business Docs Sync

    Ibrahim-3d/orchestrator-supaconductor

    A skill your agent uses when completing a track that changes pricing, AI models, product features, or asset pipelines — syncs business context documents across all tiers.

    381 GitHub stars~2.1k tokensUpdated 12 days ago
    Auto-check passed
  • Context Loader

    Ibrahim-3d/orchestrator-supaconductor

    Load project context efficiently for Conductor workflows. An agent skill from Ibrahim-3d/orchestrator-supaconductor.

    381 GitHub stars~830 tokensUpdated 12 days ago
    Auto-check passed

Questions about Architecture Lead

What does Architecture Lead do?

Architecture consultation for Conductor orchestrator. An agent skill from Ibrahim-3d/orchestrator-supaconductor. Architecture Lead is an agent skill from Ibrahim-3d/orchestrator-supaconductor. Architecture consultation for Conductor orchestrator.

When should I use Architecture Lead?

Architecture Lead fits situations like: tasks that involve Creative writing and fiction.

How do I install Architecture Lead in Claude Code?

Run `npx skills add Ibrahim-3d/orchestrator-supaconductor --skill architecture-lead -a claude-code`. Or copy the skill folder (skills/leads/architecture-lead in Ibrahim-3d/orchestrator-supaconductor) into .claude/skills/architecture-lead in your project. Claude Code loads it when a task matches its description.

How do I install Architecture Lead in Codex?

Run `npx skills add Ibrahim-3d/orchestrator-supaconductor --skill architecture-lead -a codex`. Or copy the skill folder (skills/leads/architecture-lead in Ibrahim-3d/orchestrator-supaconductor) into .agents/skills/architecture-lead in your project. Codex loads it when a task matches its description.

Can I use Architecture Lead 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 Ibrahim-3d/orchestrator-supaconductor --skill architecture-lead -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/architecture-lead, .gemini/skills/architecture-lead, .github/skills/architecture-lead and .opencode/skills/architecture-lead in your project.

What does Architecture Lead need to run?

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

Does Architecture Lead access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Architecture Lead 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 Architecture Lead use?

Architecture Lead is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Architecture Lead use?

About 1.9k tokens (SKILL.md is roughly 7.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 Architecture Lead?

Skills that share tags, products or a category with Architecture Lead: Mastering Python Skill (SpillwaveSolutions/agent-brain, 119 stars), Story Setup (Xiaoyangy/novel-studio, 131 stars), Scenario Orbit Views (scenario-labs/skills, 946 stars) and Claude Project Setup (mohitagw15856/pm-claude-skills, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architecture Lead?

Ibrahim-3d (a GitHub user) maintains it in Ibrahim-3d/orchestrator-supaconductor, which has 381 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on September 27, 2026.

Source: Ibrahim-3d/orchestrator-supaconductor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.