Skip to content

generic-automation-and-it/smooth-ai-stockanalysis / .agents/skills/create-hld

create-hld

Verified

Invoke 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.

FileKindSize
AGENTS.mdmarkdown2.4 KB
SKILL.mdskill md6.5 KB
agents/openai.yamlconfig360 B
assets/AGENTS.template.mdmarkdown1.3 KB
assets/LADR.template.mdmarkdown1.1 KB
assets/NFR.template.mdmarkdown1.1 KB
assets/README.template.mdmarkdown2.1 KB
assets/c4-context.template.mdmarkdown2.0 KB
assets/examples.README.template.mdmarkdown505 B
references/diagram-selection.mdmarkdown2.2 KB
references/status-vocabulary.mdmarkdown1.6 KB
scripts/hld-agents-rules.shexecutablescript3.3 KB
scripts/scaffold-hld.shexecutablescript4.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.
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall