lightforgelabsstudio/design
skills/design/SKILL.md
Design a feature or change into a reviewed system spec (plus a slim ADR only when the decision threshold is met). Outputs an accepted spec ready for /scope.
testing
Updated Jun 12, 2026
$ install --global
skillsauthnpx skillsauth add lightforgelabsstudio/aide designInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 12, 2026, 7:36 AM25.9s1 file scanned
SKILL.md
- name:
- design
- description:
- Design a feature or change into a reviewed system spec (plus a slim ADR only when the decision threshold is met). Outputs an accepted spec ready for /scope.
Design
Create or update the living system spec for a feature or change. Read AGENTS.md if not in context. Taxonomy: .aide/docs/core/DOCUMENT_TAXONOMY.md.
Inputs
Design question or topic. Timebox if relevant.
Review-aware
Before starting: check if <artifact>.findings.md exists for this topic. If it does, read it and incorporate findings before proceeding.
Workflow
-
GitHub state check — Run
gh issue listandgh pr listto avoid proposing already-built or conflicting work. -
Locate the system spec — Find the relevant spec in
docs/specs/(project) or.aide/docs/(AIDE framework work). If none exists for this system, you will create one named for the system, not the feature. -
Shape options — Produce 1 recommended option (+ 1 alternative max). Include: pros/cons, risks, dependencies, success validation.
-
Draft — Create or update
docs/specs/<system>.mdwith frontmatter (status: draftfor new specs). Binding rules go in the spec's Invariants section. -
ADR threshold check — Also write a slim ADR to
docs/decisions/YYYY-MM-DD-<slug>.mdonly if all three hold: real alternatives existed; the choice constrains future work; a newcomer could accidentally reverse it. The ADR points to the spec. Most features need no ADR. -
Cross-review — Use
/findingsto exchange findings before accepting. Do not accept unreviewed specs. -
Accept — Set spec frontmatter
status: accepted(and ADR status if one was written). Hand off to/scopeto decompose into GitHub issues.
Spec frontmatter
---
title: <system name>
description: <one line>
status: draft | accepted | superseded
created: YYYY-MM-DD
last_updated: YYYY-MM-DD
---
ADR format (when threshold is met)
# Title
**Status:** Accepted (durable decision — current) | Executed (historical record) | Superseded by <file>
## Context
## Decision
## Rationale
## Consequences
Reference
- Taxonomy + creation rule:
.aide/docs/core/DOCUMENT_TAXONOMY.md - Design pillars:
design/directory - Quick reference:
docs/DESIGN_QUICK_REFERENCE.md
Related Skills
lightforgelabsstudio/sanity-check
testing
VerifiedTrustedCommunity
Skeptical gap analysis for issues, ADRs, plans, and docs. Use when the user wants a second-pass check for missing decisions, contradictions, edge cases, hidden dependencies, scope drift, or readiness before implementation.
SKILL.mdUpdated May 11, 2026
lightforgelabsstudio/sync
tools
VerifiedTrustedCommunity
Sync branch with remote and confirm a clean end-of-session state.
SKILL.mdUpdated May 7, 2026
lightforgelabsstudio/skill-author
testing
VerifiedTrustedCommunity
Create or update an AIDE skill in .aide/skills with valid frontmatter and a concise workflow.
SKILL.mdUpdated May 7, 2026
lightforgelabsstudio/scope
tools
VerifiedTrustedCommunity
Decompose an accepted spec (and its ADR, if one exists) into GitHub issues using the issue-creator tool.
SKILL.mdUpdated May 7, 2026