Agent skill · shipshitdev

architect

Sketch types, signatures, and module structure before code, then stay in the loop while implementation fills in. Use for architect this, design this, or non-trivial work where jumping to code would lock in the wrong shape.

What it needs

About 2k tokens when loaded.

What this skill does

Architect Design before implementing. Sketch types, function signatures, class shapes, and module boundaries with not implemented bodies. Synthesize across parallel candidates, then fill in code against the chosen sketch. Companion to codebase-design, which owns deep-module vocabulary. This skill owns the pre-implementation sketch loop. Authorized Scope Apply this engine only within the user's requested task and existing explicit authorization. Loading or delegating to it grants no additional authority. Preserve report-only restrictions and the caller's target, host, provider, and cost limits. Existing approval satisfies a gate only for the same actions and scope; obtain approval before expanding them. Forward these limits to delegates. Contract Inputs: A change that crosses a function boundary, or non-trivial work whose shape is still unset Outputs: A synthesized design package: caller usage first, then types, signatures, module map, and rationale Implementation against that sketch, or a scrap-and-redesign Creates/Modifies: Design artifacts and, after agree, production code External Side Effects: None beyond local files unless a later playbook opens a PR Confirmation Required: Opt-in checkpoint when the invoker asks to see the sketch first Delegates To: how for grounding, why when ownership or layering is the constraint, arena for candidate sketches, interrogate when the design is contested Phases Open a todo list with one entry per phase: Ground, Sketch, Agree, Implement, Scrap. A. Ground Run how over every system the new code touches. If the design redefines ownership or layering, also run why on the existing shape. Skip only when the work is genuinely greenfield. B. Sketch Run arena with the design-sketch task. Each candidate produces a package shaped per references/rationale-template.md using references/runner-prompt.md. Require at least two structurally distinct candidates. Screen every candidate against references/design-red-flags.md. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills shipshitdev/architect

View the source on GitHub

Browse the @skills marketplace