Official agent skill

Architect Before Implementing

by cursor in cursor/plugins

Sketches types, signatures and module boundaries with stub bodies before real code, compares at least two designs, then implements against the chosen sketch.

OfficialNo licenceAuto-check passedDevelopment

Install Architect Before Implementing

skills CLI
$ npx skills add cursor/plugins --skill architect -a claude-code

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

GitHub CLI
$ gh skill install cursor/plugins 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/cursor/plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/pstack/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/

Facts

Skill name
architect
GitHub stars
10k
Used in
8 other repos
Token cost
~1.4k tokens
SKILL.md length
781 words
Files
4 (incl. references)
Skills in repo
99
Repo updated
First seen
Licence
None found

At a glance

Sketches types, signatures and module boundaries with stub bodies before real code, compares at least two designs, then implements against the chosen sketch.

  • Works in 5 steps: Ground → Sketch → Agree → …
  • Starting non-trivial work where the shape of the code is still open
  • SKILL.md covers Start, Phase A: Ground the problem, Phase B: Sketch and Phase C: Agree (opt-in), plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This skill puts design ahead of implementation for work where jumping straight to code would lock in the wrong shape. The agent opens a to-do list with five phases: ground, sketch, agree, implement and scrap. Grounding builds a traced model of every system the new code touches by running a companion `how` skill, plus a `why` skill when the design changes ownership or layering; only truly greenfield work may skip it.

In the sketch phase an `arena` skill runs several model runners on the problem, each returning a design package in the format of `references/rationale-template.md`, and at least two structurally different whole-shape candidates are required before synthesis. Candidates are screened against `references/design-red-flags.md`, on the assumption that the next contributor is an agent that copies the nearest example, and a smaller, deeper public interface is preferred. The agreement phase is opt-in, and implementation fills in code against the sketch; if the code shows the sketch is wrong, the sketch is discarded and redone.

When your agent uses it

  • Starting non-trivial work where the shape of the code is still open
  • Answering a request to architect or design a feature before any coding
  • Comparing two or more module structures before committing to one
  • Redefining ownership or layering between modules

Example prompts

  • “Architect this: a retry layer for our outbound webhooks. Sketch types and signatures first.”
  • “Design the module boundaries for the new billing sync before we write any code.”
  • “Give me two structurally different designs for the notification queue, then pick one.”

Requirements

  • The companion how, why and arena skills from the same plugin
  • Several model runners for the sketch phase

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Ground
  2. Sketch
  3. Agree
  4. Implement
  5. Scrap

What it can do on your machine

Read from SKILL.md and the folder at commit 9f451cf. 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

    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

Architect Before Implementing loads about 1.4k tokens when it runs, and up to ~3.7k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 781 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.7k

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 781 words (~1,416 tokens).

“Design before implementing. Sketch types, function signatures, class shapes, and module boundaries with not implemented bodies and pseudocode. Synthesize across multiple model perspectives, then fill in code against the chosen sketch. If implementation proves the sketch wrong, throw it out…”

— opening of SKILL.md by cursor
name
architect
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (references) in pstack/skills/architect of cursor/plugins.

  • SKILL.md
  • references/design-red-flags.md
  • references/rationale-template.md
  • references/runner-prompt.md

Open the folder on GitHubat commit 9f451cf

Used in 8 other repositories

We found 8 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 8 other GitHub owners. This page covers the copy in cursor/plugins, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Architect Before Implementing 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 Before Implementing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Architect Before Implementing this skillcursor/plugins10k8 repos~1.4kAutomated safety check: PassNone
SPARC Development Methodologyruvnet/ruflo74k2 repos~829Automated safety check: PassMIT
Think: Plan Before You Buildtw93/Waza7.2k—~3kAutomated safety check: NotesMIT
SPARC Methodologyruvnet/agentic-flow8166 repos~6.3kAutomated safety check: PassNone
GitHub Multi-Repo Coordinationruvnet/agentic-flow8165 repos~5.6kAutomated safety check: PassNone
Engineering Plan Reviewgarrytan/gstack136k—~13kAutomated safety check: NotesMIT

Similar skills

  • Applies the SPARC method (specification, pseudocode, architecture, refinement, completion) with 17 specialized modes and multi-agent orchestration, from research to deployment.

    74k GitHub starsUsed in 2 repos~829 tokens
    DevelopmentAuto-check passed
  • Turns a rough idea into an approved, decision-complete plan or recommendation before any code is written, for architecture choices and go or no-go calls.

    7.2k GitHub stars~3k tokensUpdated today
    DevelopmentAuto-check: notes
  • SPARC Methodology

    ruvnet/agentic-flow

    Structures complex feature work into five planning-first phases (specification, pseudocode, architecture, refinement and completion) driven through claude-flow commands.

    816 GitHub starsUsed in 6 repos~6.3k tokens
    DevelopmentAuto-check passed
  • Coordinates work across several GitHub repositories: swarm-driven cross-repo operations, package version and documentation sync, and repository structure optimization.

    816 GitHub starsUsed in 5 repos~5.6k tokens
    DevelopmentAuto-check passed
  • Reviews an execution plan or design doc before coding, covering architecture, data flow, edge cases, test coverage and performance, one issue at a time.

    136k GitHub stars~13k tokensUpdated today
    DevelopmentAuto-check: notes
  • Paseo Committee

    getpaseo/paseo

    Forms a two-agent committee with contrasting profiles to analyze a stuck problem in parallel, reconcile their views and return a consensus plan without editing files.

    20k GitHub starsUsed in 1 repo~496 tokens
    Agent WorkflowsAuto-check passed

More from cursor/plugins

All 99 skills in this repo
  • Official

    Keeps a TSV decision log for long or unattended agent runs, one row per decision with what, why, evidence and result, so a reviewer can check the work later.

    10k GitHub starsUsed in 9 repos~1.6k tokens
    Auto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    Auto-check passed
  • Official

    Starts three parallel reviewer subagents over the current conversation transcript, then turns their findings into concrete edits to existing skills.

    10k GitHub starsUsed in 5 repos~1.2k tokens
    Auto-check passed
  • Official

    Applies four layers of technical-writing rules to docs, RFCs, readmes, PR descriptions and commit messages so a tired engineer follows them on the first read.

    10k GitHub starsUsed in 10 repos~2.4k tokens
    Auto-check passed
  • Advisor Mode

    cursor/plugins

    Official

    Adds a second, stronger model that the main agent consults before major decisions, when stuck and before finishing, controlled by /advisor commands.

    10k GitHub stars~2.6k tokensUpdated today
    Auto-check: notes
  • Official

    Prepare PRs for review by cleaning noisy history, improving PR descriptions, and adding reviewer guidance without changing code behavior.

    10k GitHub starsUsed in 3 repos~569 tokens
    Auto-check passed

Questions about Architect Before Implementing

What does Architect Before Implementing do?

Sketches types, signatures and module boundaries with stub bodies before real code, compares at least two designs, then implements against the chosen sketch. This skill puts design ahead of implementation for work where jumping straight to code would lock in the wrong shape. The agent opens a to-do list with five phases: ground, sketch, agree, implement and scrap.

When should I use Architect Before Implementing?

Architect Before Implementing fits situations like: starting non-trivial work where the shape of the code is still open; answering a request to architect or design a feature before any coding; comparing two or more module structures before committing to one; redefining ownership or layering between modules.

How do I install Architect Before Implementing in Claude Code?

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

How do I install Architect Before Implementing in Codex?

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

Can I use Architect Before Implementing 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 cursor/plugins --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 Before Implementing need to run?

SKILL.md names no scripts, command-line tools or credentials: Architect Before Implementing is instructions for the agent only. Our summary lists: The companion how, why and arena skills from the same plugin; Several model runners for the sketch phase.

Does Architect Before Implementing 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 Architect Before Implementing 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 Before Implementing use?

No licence was found for Architect Before Implementing or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Architect Before Implementing use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.3k tokens, read only when the agent opens those files.

What are the alternatives to Architect Before Implementing?

Skills that share tags, products or a category with Architect Before Implementing: SPARC Development Methodology (ruvnet/ruflo, 74k stars), Think: Plan Before You Build (tw93/Waza, 7.2k stars), SPARC Methodology (ruvnet/agentic-flow, 816 stars) and GitHub Multi-Repo Coordination (ruvnet/agentic-flow, 816 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architect Before Implementing?

cursor (a GitHub organization, an official publisher) maintains it in cursor/plugins, which has 10,130 GitHub stars. The repository holds 99 skills in this directory. The repository was last updated on October 6, 2026.

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