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

assets/c4-context.template.md

View on GitHub
# Diagrams — {{TITLE}}

The **C1 System Context** below is the mandatory floor for every HLD. Add further diagrams
only where they earn their place (see the skill's `references/diagram-selection.md`); each
addition gets its own `## ` section here (or its own file in this folder) and a one-line
rationale.

## System Context (C1)

<2–4 sentences: what this system is and its immediate external dependencies.>

```mermaid
C4Context
    title {{TITLE}} — System Context

    Person(user, "User / Actor", "Who initiates the primary flow.")

    System(thisSystem, "{{TITLE}}", "What this component does, in one line.")

    System_Ext(ext1, "External System", "A dependency this system talks to.")

    Rel(user, thisSystem, "Uses", "HTTPS")
    Rel(thisSystem, ext1, "Calls", "Protocol")
```

---

### Authoring guide — optional additional diagrams (delete this whole section before finalizing)

The snippets below are a copy-paste catalog for the human or agent composing the HLD. They
are shown as plain `text` fences so they do not render (they contain placeholders like `...`).
When you keep one, copy it into its own `## ` section and change the fence to `mermaid`; delete
the rest **and** delete this guide section.

**Container View (C2)** — when the system splits into >1 deployable/runtime unit:

```text
C4Container
    title {{TITLE}} — Containers
    ...
```

**Flow — <named flow>** — process/decision flows; a path through the system:

```text
flowchart TD
    A[Start] --> B{Decision}
    B -->|yes| C[Action]
    B -->|no| D[Alternative]
```

**Sequence — <named flow>** — interactions with 3+ steps OR side effects (email, queue, external call):

```text
sequenceDiagram
    participant A as Caller
    participant B as Service
    A->>B: request
    B-->>A: response
```

**Data Model** — 3+ related entities with non-obvious relationships:

```text
erDiagram
    ENTITY_A ||--o{ ENTITY_B : has
```

**Domain Types** — key classes/types and their relationships:

```text
classDiagram
    class TypeA
    TypeA --> TypeB
```
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