documentation-standards
Standards for technical documentation, C4 architecture models, and Mermaid diagrams following Hack23 guidelines
ソース情報
- リポジトリ
- Hack23/riksdagsmonitor
- ソースの最終更新活動
- 2026年4月16日 09:31
- 検出された SKILL.md の言語
- 英語
- スター
- 13
- フォーク
- 3
インストール方法
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
ソースファイルを確認
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SKILL.md を表示中
SKILL.md
ソースの指示 · 読み取り専用プレビュー- name
- documentation-standards
- description
- Standards for technical documentation, C4 architecture models, and Mermaid diagrams following Hack23 guidelines
- license
- Apache-2.0
# Documentation Standards Skill
## 🔴 AI FIRST Quality Principle
> **Apply the AI FIRST principle: never accept first-pass quality. Minimum 2 iterations. Read all output, improve every section. No shortcuts.**
## Purpose
Ensure consistent, high-quality technical documentation following C4 architecture model and Hack23 standards.
## Document Structure Template
```markdown
# Title - [Purpose]
**Document Version:** X.X
**Last Updated:** YYYY-MM-DD
**Classification:** [Public/Internal]
**Owner:** Hack23 AB (Org.nr 5595347807)
## Executive Summary
[High-level overview]
## 1. Main Content
[Sections with diagrams]
## Related Documentation
[Links to related docs]
---
**Document Control:**
- **Repository:** [URL]
- **Path:** /DOCUMENT.md
- **Format:** Markdown with Mermaid
- **Next Review:** YYYY-MM-DD
```
## C4 Architecture Model
### Level 1: System Context
```mermaid
graph TB
User[Users]
System[System]
External[External System]
User --> System
System --> External
```
### Level 2: Container
```mermaid
graph TB
subgraph "System"
App[Application]
DB[Database]
end
User --> App
App --> DB
```
### Level 3: Component
```mermaid
graph TB
subgraph "Application"
Controller[Controller]
Service[Service]
Repository[Repository]
end
```
## Mermaid Diagram Best Practices
1. Use clear, descriptive labels
2. Consistent styling with subgraphs
3. Appropriate diagram types
4. Color coding for clarity
5. Legend when needed
## Remember
- **Clarity First**: Easy to understand
- **Consistency**: Follow standards
- **Visual**: Use diagrams
- **Completeness**: All required docs
- **Maintenance**: Regular reviews
## References
- [C4 Model](https://c4model.com/)
- [Mermaid](https://mermaid.js.org/)
GitHubで見る