skills.rest
HendrikGC02
HendrikGC02COMMUNITY
Explore all skills by this author →
GitHub

architect

Spawns an architect agent that researches goals, proposes solution paths, and files specs.

Updated Dec 27, 2025
Search Tags:#planning#pull request#agent#roadmap#spec#architect#goal capture
One-click install
npx skills add https://github.com/HendrikGC02/Astroray --skill architect-hendrikgc02
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architect
Source: https://github.com/HendrikGC02/Astroray/tree/main/.claude/skills/architect
Command: npx skills add https://github.com/HendrikGC02/Astroray --skill architect-hendrikgc02

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a vague project desire into a concrete, prioritized plan requires reading project state, researching options, and documenting decisions. This Skill captures a stated goal and drives an architect agent through research, dialogue, spec filing, and PR creation. ## Core Features & Use Cases - Goal Capture: Passes the user's verbatim goal to the architect agent in goal-capture mode. - Silent Repo Research: Reads STATUS.md, ROADMAP.md, NEXT_STAGE_REPORT.md, and research notes before opening dialogue, avoiding redundant questions. - Opinionated Proposals: Forms a position first, presents variable-N solution paths with tradeoffs, and flags conflicts with project priorities. - Spec Filing and PRs: After dialogue converges, files new specs, updates ROADMAP/STATUS, and opens a pull request. - Use Case: A maintainer of a path tracer types /architect "let's go after viewport perf" and receives researched options, a focused dialogue, and a filed spec with a PR. ## Quick Start Invoke /architect followed by a quoted goal such as /architect "I want to render a prism dispersing light" to start the goal-capture dialogue.

Frequently Asked Questions about architect

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

FAQPage Schema
How do I turn a feature idea into a spec and PR?▼

Invoke /architect with your goal in quotes, such as /architect "add pbrt-v4 scene import". The architect agent researches the repo, proposes solution paths, dialogues with you, then files specs and opens a PR.

What does the architect agent read before responding?▼

It reads STATUS.md, ROADMAP.md, NEXT_STAGE_REPORT.md, and relevant research notes silently before opening dialogue. It will not ask questions about what is already in the repo.

Can the architect agent push back on my goal?▼

Yes. The agent forms an opinion before presenting options and states upfront if your goal conflicts with project priorities. It then presents variable-N solution paths with tradeoffs.

What happens after the planning dialogue converges?▼

The architect files new spec documents, updates ROADMAP and STATUS if the direction changed, and opens a pull request containing the results.

When should I not use goal-capture mode?▼

Avoid it for small bug fixes or tasks with an already-decided implementation, since the agent is designed for open-ended goals requiring research, tradeoff analysis, and dialogue.

Related Skills

Explore More Software Engineering Skills→
richard-jh-mccraerichard-jh-mccrae

auto-grill-with-docs

Conducts repository-grounded design discovery with automatic recommendations and one approval.

Community
Basic
LibPDF-jsLibPDF-js
1.8k

implement-spec

Select a spec file from .agents/plans/ and implement it with tests, typecheck, and lint.

Official
Advanced
batFormatbatFormat

aif-roadmap

Generate and manage project roadmaps with milestone progress tracking.

Community
Intermediate
jeremybrasherjeremybrasher

principle-minimize-reader-load

Reviews code to reduce indirection layers and hidden mutable state for readers.

Community
Intermediate