Agent skill

bkit-templates

PDCA document templates — Plan, Design, Analysis, Report with consistent structure. Triggers: template, plan document, design template, 템플릿, 문서 양식.

View SKILL.md on GitHub Repository
Stars 491
Forks 125

Install this agent skill to your Project

npx add-skill https://github.com/popup-studio-ai/bkit-claude-code/tree/main/skills/bkit-templates

SKILL.md

bkit Document Templates

Use these templates when generating PDCA documents.

Available Templates

Template Path Purpose
Plan ${CLAUDE_PLUGIN_ROOT}/templates/plan.template.md Feature planning
Design ${CLAUDE_PLUGIN_ROOT}/templates/design.template.md Technical design
Analysis ${CLAUDE_PLUGIN_ROOT}/templates/analysis.template.md Gap analysis
Report ${CLAUDE_PLUGIN_ROOT}/templates/report.template.md Completion report
Index ${CLAUDE_PLUGIN_ROOT}/templates/_INDEX.template.md Document index
CLAUDE ${CLAUDE_PLUGIN_ROOT}/templates/CLAUDE.template.md CLAUDE.md template

Template Usage

Plan Template

For Plan phase - feature planning before design.

Key sections:

  • Overview & Purpose
  • Scope (In/Out)
  • Requirements (Functional/Non-Functional)
  • Success Criteria
  • Risks & Mitigation

Design Template

For Do phase - technical design before implementation.

Key sections:

  • Architecture (diagrams, data flow)
  • Data Model (entities, relationships)
  • API Specification (endpoints, request/response)
  • UI/UX Design (layouts, components)
  • Error Handling
  • Security Considerations
  • Test Plan
  • Implementation Guide

Analysis Template

For Check phase - gap analysis between design and implementation.

Key sections:

  • Design vs Implementation comparison
  • Missing features
  • Inconsistencies
  • Quality metrics
  • Recommendations

Report Template

For Act phase - completion report and lessons learned.

Key sections:

  • Summary of completed work
  • Metrics (LOC, test coverage, etc.)
  • Issues encountered
  • Lessons learned
  • Future improvements

Document Output Paths

docs/
├── 01-plan/
│   └── features/
│       └── {feature}.plan.md
├── 02-design/
│   └── features/
│       └── {feature}.design.md
├── 03-analysis/
│   └── features/
│       └── {feature}.analysis.md
└── 04-report/
    └── features/
        └── {feature}.report.md

Variable Substitution

Templates use {variable} syntax:

  • {feature}: Feature name
  • {date}: Creation date (YYYY-MM-DD)
  • {author}: Document author

Pipeline Templates

Additional templates for Development Pipeline phases:

  • ${CLAUDE_PLUGIN_ROOT}/templates/pipeline/ directory

Document Standards

File Naming Rules

{number}_{english_name}.md      # 01_system_architecture.md
{number}-{english_name}.md      # 01-system-architecture.md
{feature}.{type}.md             # login.design.md

Common Header

All documents should include:

markdown
# {Document Title}

> **Summary**: {One-line description}
>
> **Author**: {Name}
> **Created**: {YYYY-MM-DD}
> **Last Modified**: {YYYY-MM-DD}
> **Status**: {Draft | Review | Approved | Deprecated}

---

Version Control

Track changes within documents:

markdown
## Version History

| Version | Date | Changes | Author |
|---------|------|---------|--------|
| 1.0 | 2024-12-01 | Initial draft | Kay |
| 1.1 | 2024-12-05 | Added API spec | Kay |

Cross-References

Link related documents:

markdown
## Related Documents
- Plan: [login.plan.md](../01-plan/features/login.plan.md)
- Design: [login.design.md](../02-design/features/login.design.md)
- Analysis: [login.analysis.md](../03-analysis/features/login.analysis.md)

Status Tracking

Use _INDEX.md in each folder:

Status Meaning Claude Behavior
✅ Approved Use as reference Follow as-is
🔄 In Progress Being written Notify of changes
⏸️ On Hold Temporarily paused Request confirmation
❌ Deprecated No longer valid Ignore

Conflict Resolution

  • Code vs Design mismatch: Code is truth, suggest document update
  • Multiple versions: Reference only the latest version

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

popup-studio-ai/bkit-claude-code

phase-5-design-system

491 125
Explore
popup-studio-ai/bkit-claude-code

zero-script-qa

Zero Script QA — test without scripts using structured JSON logging and Docker monitoring. Triggers: zero-script-qa, log testing, docker logs, QA, 제로 스크립트 QA.

491 125
Explore
popup-studio-ai/bkit-claude-code

phase-6-ui-integration

Implement frontend UI and integrate with backend APIs — state management and API clients. Triggers: UI integration, frontend-backend, API client, 프론트엔드 통합, UI 구현.

491 125
Explore
popup-studio-ai/bkit-claude-code

phase-3-mockup

Create UI/UX mockups and HTML/CSS/JS prototypes without a designer. Triggers: mockup, prototype, wireframe, UI design, 목업, 프로토타입.

491 125
Explore
popup-studio-ai/bkit-claude-code

desktop-app

Desktop app development guide — Electron and Tauri for cross-platform apps. Triggers: desktop app, Electron, Tauri, mac app, windows app, 데스크톱 앱.

491 125
Explore
popup-studio-ai/bkit-claude-code

btw

By-The-Way: 작업 중 개선 제안을 즉시 수집하고 관리하는 스킬. Triggers: /btw, /btw list, /btw analyze, /btw promote, /btw stats Keywords: btw, 개선, 제안, suggestion, improve, idea, feedback

491 125
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results