GitHub - Xm3Ga/architecture-design: Codex skill to generate spec-sheets for SDD (Spec Driven Development) · GitHub

/" data-turbo-transient="true" />

Skip to content

Type / to search

Sign in<br>Sign upAppearance settings

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

Xm3Ga

architecture-design

Public

Notifications<br>You must be signed in to change notification settings

Fork

Star

main

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>2 Commits<br>2 Commits

agents

agents

references

references

scripts

scripts

README.md

README.md

SKILL.md

SKILL.md

View all files

Repository files navigation

Architecture Design

architecture-design is a Codex skill that turns vague software ideas, planned features, migrations, and redesigns into right-sized, implementation-ready specifications.

It does not assume every project needs a large architecture or a pile of documents. It starts with the simplest viable design, adds complexity only when a real requirement or risk justifies it, and records unresolved uncertainty instead of inventing false precision.

What it does

Interviews you to clarify outcomes, users, workflows, constraints, risks, and success criteria.

Inspects an existing codebase before designing brownfield changes.

Sizes the work as Pocket, Lean, Standard, or Assured and proposes the smallest useful artifact set.

Compares viable architecture options, including the simplest baseline, and explains the tradeoffs.

Produces a traceable specification covering behavior, boundaries, data, quality requirements, delivery tasks, and verification.

Uses independent adversarial reviewers to challenge requirements, simplicity, implementability, verification, and any risk-specific concerns.

Adjudicates criticism instead of accepting it blindly, then reports residual risks and open questions.

How it works

Discover intent: Ask only questions that can materially change the product, architecture, scope, or acceptance criteria.

Right-size the design: Match the depth of the architecture and documentation to the project's actual complexity and risk.

Choose an architecture: Compare two or three credible options for consequential decisions and recommend the best fit.

Draft the specification: Create the minimum sufficient engineering contract for spec-driven development.

Review adversarially: Give independent subagents the raw draft, verify their findings, and revise justified issues.

Converge: Validate traceability and testability, then deliver a reviewed spec with no known blocking issues.

Install

In Codex, use the built-in skill installer:

$skill-installer Install the architecture-design skill from https://github.com/Xm3Ga/architecture-design.git

Codex should detect the installed skill automatically. Restart Codex if it does not appear. See the official OpenAI skill documentation for more about installing and invoking skills.

Use

This skill requires explicit invocation. Start your prompt with $architecture-design:

$architecture-design Turn my idea for a collaborative meal-planning app into an implementation-ready specification.

You can also use it for existing systems or specifications:

$architecture-design Design a safe migration from our monolith to a modular architecture. Inspect the repository first.

$architecture-design Review this specification, find architectural flaws, and simplify anything that is not justified.

Expect an iterative conversation. The skill may ask follow-up questions, present architecture choices for feedback, or recommend a small experiment when evidence is needed before committing to a design.

About<br>Codex skill to generate spec-sheets for SDD (Spec Driven Development)<br>Resources<br>Readme<br>Activity<br>Stars<br>0 stars<br>Watchers<br>0 watching<br>Forks<br>0 forks<br>Report repository

Releases

Packages

Contributors

Languages

You can’t perform that action at this time.