Skip to content
cccskills
FreePublished on GitHub

solution-design

Explores ambiguous product or engineering intent before implementation, clarifies users, constraints, alternatives, risks, and acceptance criteria, and turns the result into an approved design direction. Use for a new feature, subsystem, creative UI, architecture change, or unclear request. Not for an already-scoped bug fix, an existing implementation plan, or a narrow code review.

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md2.7 KB
  • references/discovery-questions.md794 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Solution Design

Make the problem concrete before choosing the solution. The goal is shared understanding, not a long ceremony.

Classify the request

  • Spike: the output is a recommendation or feasibility result; keep any prototype disposable.
  • Bounded: an existing flow is understood and the change is narrow; use a short design and one approval gate.
  • Architectural: the request creates a subsystem, changes a public contract, or has several independent surfaces; write a design artifact.

When uncertain, choose the heavier path until discovery proves otherwise.

Explore in order

  1. Read repository instructions, nearby code, tests, and recent changes.
  2. Separate observed facts from assumptions and unknowns.
  3. Ask only the questions that change scope, safety, data shape, or user outcome. Ask one focused question at a time when a conversation is needed.
  4. State the outcome, users, constraints, non-goals, acceptance evidence, and principal risks.
  5. Compare two or three viable approaches when the choice is material. Explain the trade-off and recommend the smallest safe option.
  6. Present the design at the depth the request requires. Get approval before consequential implementation when the user has not already authorized it.

Use discovery-questions.md when the brief has unclear goals or competing stakeholders.

Design artifact

For architectural work, save a concise design under the repository's normal docs location. Include:

Problem and users
Outcome and non-goals
Constraints and assumptions
Options considered and recommendation
Interfaces and data affected
Failure modes and rollback
Acceptance evidence
Open decisions

Do not start implementation while a decision that materially changes the public behavior, data model, or safety boundary is unresolved.

Handoff

  • Hand an approved multi-step design to implementation-planning.
  • Hand a concrete failure to root-cause-debugging.
  • Add a domain skill only when its expertise changes the design.

Completion condition

Solution design is complete when the outcome, scope, constraints, acceptance evidence, risks, and next decision are explicit. A polished idea without a testable outcome is not a completed design.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Designs and runs reproducible evaluations for AI agents, prompts, tools, skills, and model-backed workflows using realistic datasets, isolated baselines, objective assertions, rubric grading, trajectory analysis, cost/latency tracking, and regression comparison. Use when measuring agent quality, optimizing skill triggering, comparing prompts or models, or gating an AI feature release. Not for ordinary deterministic unit tests.

The English summary is being prepared. Showing the original description.

thiientv/godmode99Updated Aug 26, 2026

Designs or reviews HTTP, REST, GraphQL, RPC, CLI, webhook, event, and service interfaces with explicit inputs, outputs, errors, compatibility, idempotency, pagination, authentication, versioning, and observability. Use when introducing or changing an API or cross-component contract. Not for internal implementation details with no boundary or for debugging one API failure; use root-cause-debugging there.

The English summary is being prepared. Showing the original description.

thiientv/godmode99Updated Aug 26, 2026

Reviews an existing codebase for structural friction, unclear ownership, leaky or shallow interfaces, excessive coupling, misplaced state, poor testability, and risky dependency direction, then prioritizes evidence-backed improvement candidates. Use for architecture audits, modularization, modernization, or recurring cross-cutting change pain. Not for designing one new interface, simplifying a local function, or fixing a reproduced bug.

The English summary is being prepared. Showing the original description.

thiientv/godmode99Updated Aug 26, 2026

Validates a running application, CLI, API, service, or generated artifact as a user or operator against a prewritten observable behavior contract while remaining source-blind. Use for acceptance checks, runtime proof, anti-fake probes, release smoke tests, or an independent companion to code review. Not for source-quality findings, root-cause diagnosis, or visual design judgment outside the contract.

The English summary is being prepared. Showing the original description.

thiientv/godmode99Updated Aug 26, 2026

Closes a completed development branch by checking the final diff and proof, presenting merge, pull-request, keep, or discard options, and cleaning up only after the user or repository workflow chooses a path. Use when feature work is complete and the branch must be integrated or retired. Not for claiming a feature is complete before verification.

The English summary is being prepared. Showing the original description.

thiientv/godmode99Updated Aug 26, 2026

Tests a real web user flow with a browser by asserting semantic behavior, network and loading states, keyboard access, responsive layouts, and stable visual evidence. Use for browser bugs, end-to-end UI behavior, responsive or accessibility checks, and screenshot baselines. Not for static source review without a browser or for backend-only tests.

The English summary is being prepared. Showing the original description.

thiientv/godmode99Updated Aug 26, 2026

See all skills by thiientv

Report a problem with this skill