一键在 Manus 中运行任何 Skill

document-decision

星标2

分支1

更新时间2026年1月19日 08:03

Create Architecture Decision Records (ADRs) documenting WHY decisions were made. Uses standard ADR format (Status/Context/Decision/Consequences).

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

a-scolan

a-scolan/c4-hands-on-demo

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

Document Architecture Decision

Use this skill when recording system design decisions for LikeC4-modeled architectures.

Purpose

Create Architecture Decision Records (ADRs) that explain WHY architectural choices were made in the system diagrams, not HOW the diagrams are built or maintained.

Scope

✅ System design decisions (e.g., why Kong API Gateway vs HAProxy, why MongoDB vs PostgreSQL)
✅ Container-level technology choices (e.g., why RabbitMQ for queuing, why MinIO for storage)
✅ Component architecture patterns (e.g., why async processing, why microservices)
✅ Deployment infrastructure choices (e.g., why 3-node replication, why specific VM sizing)
❌ NOT repository structure, tooling, CI/CD setup, or LikeC4 modeling decisions

Format

Filename: ADR/NNNN-decision-title.md (manually increment NNNN)
Template: Use ADR/0000-template.md as reference
Sections: Status, Context, Decision, Consequences (Positive/Negative/Neutral)

Example

# ADR-0001: API Gateway Selection - Kong vs HAProxy

## Status
Accepted

## Context
Legacy system used HAProxy as a simple load balancer. Microservices architecture requires:
- API-aware routing based on paths, headers, JWT claims
- Built-in authentication (JWT validation, OAuth2)
- Rate limiting and circuit breakers
- Plugin ecosystem for extensibility

## Decision
Upgrade from HAProxy to Kong API Gateway

## Consequences

### Positive
- Routes to multiple backend services with path-based rules
- JWT validation out-of-the-box, reducing custom auth code
- Production-grade rate limiting without custom implementation
- Extensible via Lua plugins

### Negative
- More complex configuration than HAProxy
- Requires learning Kong admin API and declarative config
- Higher resource footprint (but acceptable for use case)

Integration with LikeC4

Reference elements from diagrams: "The decision affects mySystem.apiGateway (Container_ReverseProxy)"
Link to views: "See deployment view: deployment_api_tier"
Tag related decisions: Use frontmatter or Notes section to link ADRs

同仓库更多 Skills

同仓库

design-view

a-scolan/c4-hands-on-demo

Design views with proper includes/excludes and basic layout. Use for include patterns, tag filtering, and simple rank hints. For advanced styling/navigation, use customize-view.

2026-01-232

model-deployment

a-scolan/c4-hands-on-demo

Model deployment infrastructure (environments, zones, VMs, apps) with proper hierarchy and instanceOf links. Organize zones into tiers (DMZ, App, Data, Processing) with rich descriptions including VLAN/network specifications.

2026-01-232

write-rich-descriptions

a-scolan/c4-hands-on-demo

Use metadata for system models (business/technical context) and markdown tables for deployment models (infrastructure specs). Makes models queryable and self-documenting.

2026-01-232

c4-modeling-process

a-scolan/c4-hands-on-demo

C4 modeling methodology - design system hierarchy top-to-bottom from Context to Components. Ensures consistent, stakeholder-focused architecture documentation.

2026-01-202

configure-project-includes

a-scolan/c4-hands-on-demo

Manage likec4.config.json includes and image aliases. Ensures relative paths and preserves existing configuration. Support multi-file organization (system-model + system-views + deployment + operations).

2026-01-202

create-element

a-scolan/c4-hands-on-demo

Create elements with proper naming (PascalCase kinds, camelCase vars), required metadata (technology, description), and correct hierarchy.

2026-01-202

Document Architecture Decision

Use this skill when recording system design decisions for LikeC4-modeled architectures.

Purpose

Create Architecture Decision Records (ADRs) that explain WHY architectural choices were made in the system diagrams, not HOW the diagrams are built or maintained.

Scope

✅ System design decisions (e.g., why Kong API Gateway vs HAProxy, why MongoDB vs PostgreSQL)

✅ Container-level technology choices (e.g., why RabbitMQ for queuing, why MinIO for storage)

✅ Component architecture patterns (e.g., why async processing, why microservices)

✅ Deployment infrastructure choices (e.g., why 3-node replication, why specific VM sizing)

❌ NOT repository structure, tooling, CI/CD setup, or LikeC4 modeling decisions

Format

Filename: ADR/NNNN-decision-title.md (manually increment NNNN)

Template: Use ADR/0000-template.md as reference

Sections: Status, Context, Decision, Consequences (Positive/Negative/Neutral)

Example

# ADR-0001: API Gateway Selection - Kong vs HAProxy ## Status Accepted ## Context Legacy system used HAProxy as a simple load balancer. Microservices architecture requires: - API-aware routing based on paths, headers, JWT claims - Built-in authentication (JWT validation, OAuth2) - Rate limiting and circuit breakers - Plugin ecosystem for extensibility ## Decision Upgrade from HAProxy to Kong API Gateway ## Consequences ### Positive - Routes to multiple backend services with path-based rules - JWT validation out-of-the-box, reducing custom auth code - Production-grade rate limiting without custom implementation - Extensible via Lua plugins ### Negative - More complex configuration than HAProxy - Requires learning Kong admin API and declarative config - Higher resource footprint (but acceptable for use case)

Integration with LikeC4

Reference elements from diagrams: "The decision affects mySystem.apiGateway (Container_ReverseProxy)"

Link to views: "See deployment view: deployment_api_tier"

Tag related decisions: Use frontmatter or Notes section to link ADRs

name	document-decision
description	Create Architecture Decision Records (ADRs) documenting WHY decisions were made. Uses standard ADR format (Status/Context/Decision/Consequences).