generic-automation-and-it/smooth-ai-stockanalysis / .agents/skills/create-hld
create-hld
VerifiedInvoke to author a High-Level Design (HLD) at discovery / prototyping phase. Design-only: delivers intent + spec for AI and humans to build against — no implementation plan, no code outside examples/. Trigger keywords: "HLD", "high level design", "design doc", "architecture design", "create a design". Also triggers on /create-hld.
| File | Kind | Size |
|---|---|---|
| AGENTS.md | markdown | 2.4 KB |
| SKILL.md | skill md | 6.5 KB |
| agents/openai.yaml | config | 360 B |
| assets/AGENTS.template.md | markdown | 1.3 KB |
| assets/LADR.template.md | markdown | 1.1 KB |
| assets/NFR.template.md | markdown | 1.1 KB |
| assets/README.template.md | markdown | 2.1 KB |
| assets/c4-context.template.md | markdown | 2.0 KB |
| assets/examples.README.template.md | markdown | 505 B |
| references/diagram-selection.md | markdown | 2.2 KB |
| references/status-vocabulary.md | markdown | 1.6 KB |
| scripts/hld-agents-rules.shexecutable | script | 3.3 KB |
| scripts/scaffold-hld.shexecutable | script | 4.7 KB |
references/status-vocabulary.md
View on GitHub# HLD Status Vocabulary
Shared lifecycle vocabulary for discovery/prototyping HLDs. Use consistently across
README, AGENTS.md, LADRs, and NFRs.
| Term | Applies to | Meaning |
|---|---|---|
| **In Discovery** | HLD (README metadata) | The initiative is in discovery; decisions and quality spec are still in flux. |
| **Draft** | LADR / NFR | Under active discovery. Directional but not yet validated. Default in an in-discovery HLD. |
| **Prototype** | LADR / NFR | Directional, under active validation. Work may begin against it; treat as load-bearing but flag deviations. |
| **Accepted** | LADR / NFR | Locked in. Implementations can rely on it. |
| **Superseded by LADR-MM** | LADR | Replaced; keep the file and add a supersession note at the top. |
| **Deprecated** | LADR | Capability removed; keep the file for history. |
| **TBD** | Anywhere | Acknowledged unknown. Must have an owner or a trigger to resolve. |
`Draft → Prototype → Accepted` is the typical progression. At discovery phase, new LADRs and
NFRs default to **Draft**. A well-validated design may open directly at **Prototype**.
## Strategic vs tactical LADRs
- **Strategic** (LADR-01..N) — *what* we are building and *why*.
- **Tactical** (LADR-N+1..M) — *how* we will execute (runtime, protocol, config choices).
Number strategic first; never renumber when adding tactical LADRs.
## Conventions
- Dates ISO 8601 (`YYYY-MM-DD`). Convert relative dates ("next sprint") to absolute before saving.
- Present tense for current state; future tense only for unshipped capability.
- No `[TODO]` placeholders in finalised sections — use `TBD` with an owner/trigger.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |