メニュー
This skill should be used when the user asks to "create ADR", "document decision", "architecture decision", "add decision record", or mentions needing to record a technical decision with status tracking and category organization.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Use when the user asks to "create a tortoise model", "new tortoise project", "tortoise orm", "async orm", "aerich migration", "fastapi tortoise", "tortoise model abstract", "tortoise base class", or mentions Tortoise ORM project structure, model organization, querysets, signals, transactions, or testing. Provides opinionated enterprise patterns: model-per-file, abstract Base interfaces for mocks/transitions, strict class member ordering, FastAPI lifespan, built-in Tortoise migrations (never Aerich), Pydantic v2, pytest.
Use when the user wants to embed an architecture diagram directly inside a React/Vite site as inline SVG (no html2canvas, no external scripts, no separate HTML file). Produces an `arch-diagram` fenced markdown block that the site's React renderer expands — including `<lucide-icon>` placeholders for semantic icons. Companion to the `architecture-diagram` skill, which produces standalone HTML.
Use when the user asks for a system, infrastructure, cloud, security, network topology, or architecture diagram. Produces polished dark-themed self-contained HTML+SVG files with mathematically-correct label placement, clean-background priority, text halos, and leader lines.
Use when the user asks for a mindmap, mind-map, concept map, idea tree, brainstorm diagram, or any radial topic explosion ("draw a mindmap of X", "map out the themes around Y", "mindmap the differentiators of Z"). Produces dark-themed self-contained HTML+SVG with a central root, branches radiating in all directions, halo text, Q-curved Bezier connectors, and geometry-audit gating.
Use when the user asks for a sequence diagram, ladder diagram, message-exchange diagram, or any temporal flow showing who talks to whom in order ("draw the OAuth flow", "show the request lifecycle", "diagram the protocol over time", "sequence diagram for X"). Produces dark-themed self-contained SVG with actor lifelines, sync/async/return messages, self-loops, halo text, and a geometry-audit gate that knows about lifelines.
This skill should be used when the user asks to "create a secondbrain", "scaffold knowledge base", "init documentation portal", "set up second brain", "create TDA project", or mentions wanting to build a personal knowledge management system with VitePress and microdatabases.
| name | secondbrain-adr |
| description | This skill should be used when the user asks to "create ADR", "document decision", "architecture decision", "add decision record", or mentions needing to record a technical decision with status tracking and category organization. |
Create numbered ADRs with category-based organization and status workflow.
Verify ADR entity is enabled in the secondbrain project:
.claude/data/adrs/meta.yaml (sharded) or .claude/data/adrs/records.yaml (legacy)secondbrain-init with ADRs enabledEntityTable component on docs/adrs/index.md, which reads from .claude/data/adrs/ shard files. No sidebar modification is needed.Collect from user or conversation context:
Category (determines number range):
infrastructure (0001-0999) — Architecture & infrastructurefeature (2000-2999) — Feature implementationprocess (3000-3999) — Process & workflowTitle — Brief decision title (will be slugified for filename)
Context — What problem prompted this decision?
.claude/data/adrs/meta.yaml (read last_number — tiny file, ~50 tokens)ADR-XXXX (zero-padded)Number Ranges:
infrastructure: 0001 - 0999
feature: 2000 - 2999
process: 3000 - 3999
Use template from ${CLAUDE_PLUGIN_ROOT}/templates/entities/adr/TEMPLATE.md:
Filename: docs/adrs/ADR-XXXX-<title-slug>.md
Frontmatter:
---
id: ADR-XXXX
status: draft
date_created: YYYY-MM-DD
date_updated: YYYY-MM-DD
author: <author>
category: <category>
---
Add entry to the current month's shard .claude/data/adrs/YYYY-MM.yaml:
- number: XXXX
title: "<title>"
status: draft
category: <category>
created: YYYY-MM-DD
file: docs/adrs/ADR-XXXX-<slug>.md
author: <author>
Update last_number in .claude/data/adrs/meta.yaml and ensure the current month is in the shards list.
DO NOT manually add ADRs to VitePress sidebar.
ADRs are automatically listed via the EntityTable component on docs/adrs/index.md, which reads from .claude/data/adrs/ shard files. No sidebar modification needed.
## ADR Created
**ID:** ADR-0012
**Title:** Kubernetes Migration Strategy
**Category:** infrastructure
**Status:** draft
**File:** docs/adrs/ADR-0012-kubernetes-migration-strategy.md
### Next Steps
1. Edit the ADR to add context, options, and decision
2. Change status to 'proposed' when ready for review
3. Use /secondbrain-adr-status to update status
### Status Workflow
draft → proposed → admitted → applied → implemented → tested
Draft → Proposed → Admitted → Applied → Implemented → Tested
↘ Rejected
↘ Canceled
| Status | Description |
|---|---|
| draft | Initial creation, under development |
| proposed | Ready for review |
| admitted | Approved, pending implementation |
| applied | Implementation started |
| implemented | Implementation complete |
| tested | Verified in production |
| rejected | Not approved |
| canceled | Abandoned |
references/adr-template.md — Full ADR template