mcpField
L
likec4-architecture

likec4-architecture

github.com/timseriakovDevelopment454 installsUpdated 33w ago
Repository

About likec4-architecture

A workflow skill for creating and maintaining LikeC4 software architecture models. It guides teams from model structure and focused views through CLI validation and preview or export commands.

Key features

  1. 01Reuse or bootstrap model files
  2. 02Define elements and relationships
  3. 03Create focused architecture views
  4. 04Validate models with LikeC4 CLI
  5. 05Provide preview and export commands

Use cases

  1. 01Start an architecture model for a system
  2. 02Organize diagrams by domain or team
  3. 03Validate architecture changes before sharing

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/timseriakov/likec4-architecture-skill --skill likec4-architecture

After installing, type/likec4-architecturein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README.md
agents/
openai.yaml
assets/likec4-starter/docs/architecture/
model.c4
evaluations/
create-new-model.json
export-artifacts.json
update-existing-model.json
references/
examples.md
likec4-capabilities-reference.md
likec4-checklist.md
likec4-dsl-quickstart.md
likec4-patterns.md
scripts/
bootstrap_likec4_starter.sh

Details

From the project README

LikeC4 Architecture

Model software architecture in LikeC4, keep it executable, and return validation-backed outputs.

Workflow

  1. Scope the model:
  • Identify system boundary and audience.
  • Start with context and container views unless user asks otherwise.
  1. Locate model files:
  • Reuse existing .c4/.likec4 files when present.
  • If missing, bootstrap from assets/likec4-starter/docs/architecture/model.c4.
  1. Model structure before visuals:
  • Define stable element IDs and meaningful names.
  • Add explicit directional relationships with short labels.
  • Add technology/description fields where helpful.
  1. Keep views focused:
  • Build small, purposeful views.
  • Split crowded diagrams by domain, team, or bounded context.
  1. Validate and package:
  • Run npx likec4 validate and fix all errors.
  • Provide npx likec4 start preview command.
  • If requested, provide build/export commands.

Required Quality Gates

  • Do not leave unlabeled ambiguous relationships.
  • Do not leave orphan elements that never appear in views.
  • Prefer domain names over implementation noise in element titles.
  • Finish only after successful CLI validation.

Command Set

Use the minimal commands needed for the task:

npx likec4 validate
npx likec4 start
npx likec4 build -o ./dist
npx likec4 export png -o ./assets/architecture

Output Contract

When architecture files change, return:

  1. Changed files.
  2. Validation result.
  3. One-line purpose for each view.
  4. Preview/build/export command(s) relevant to the request.

Resources

  • CLI and modeling checklist: references/likec4-checklist.md
  • Starter model template: assets/likec4-starter/docs/architecture/model.c4
  • Bootstrap helper: scripts/bootstrap_likec4_starter.sh

Comments

Markdown supported