스킬 project-planning

📋

project-planning

Name: project-planning
Author: ByronWilliamsCPA

안전 ⚙️ 외부 명령어🌐 네트워크 접근📁 파일 시스템 액세스

プロジェクト計画ドキュメントを生成

明確な計画なしに新しいプロジェクトを開始すると、アーキテクチャの乱れやコンテキストの喪失につながります。このスキルは、AI支援開発を導き、コーディングセッション全体での一貫性を維持する4つの必須ドキュメント(PVS、ADR、技術仕様、ロードマップ)を生成します。

지원: Claude Code(CC)

📊 71 적절함

스킬 ZIP 다운로드

Claude에서 업로드

설정 → 기능 → 스킬 → 스킬 업로드로 이동

토글을 켜고 사용 시작

테스트해 보기

"project-planning" 사용 중입니다. 個人用フレグランス評価アプリの計画ドキュメントを生成

예상 결과:

docs/planning/に4つの計画ドキュメントを作成:
- project-vision.md (問題定義とスコープ)
- tech-spec.md (Python/FastAPI/SQLiteスタック仕様)
- roadmap.md (4段階実装計画)
- adr/adr-001-monolith-choice.md (アーキテクチャ決定)
次のステップ:
1. 各ドキュメントの正確性をレビュー
2. 実行: /plan synthesize でPROJECT-PLAN.mdを作成
3. フェーズ0開始: /git/milestone start feat/phase-0-foundation

"project-planning" 사용 중입니다. データベース選択のADRを作成

예상 결과:

docs/planning/adr/adr-002-database-choice.mdを作成:
- コンテキスト: 現在のデータ要件と制約
- 決定: PostgreSQL with SQLAlchemy ORM
- 検討した代替案: SQLite、MongoDB、MySQL
- 影響: マイグレーション、ホスティング要件、スケーリングパス

"project-planning" 사용 중입니다. フェーズ1完了後のロードマップ更新

예상 결과:

docs/planning/roadmap.mdを更新:
- すべてのフェーズ1タスクを完了としてマーク
- フェーズ1マイルストーンに完了率を追加
- フェーズ2タスクをTODOリストに移動
- 実際のベロシティに基づいてタイムラインを更新

보안 감사

안전

v5 • 1/16/2026

All 214 static findings are FALSE POSITIVES. The analyzer misinterprets markdown backtick syntax as Ruby/shell command execution, documentation references to algorithms as cryptographic usage, and file path patterns as path traversal. This is a pure documentation skill containing only markdown files and one benign Python validation script that reads files without network calls, file writes, or command execution.

스캔된 파일

2,182

분석된 줄 수

발견 사항

총 감사 수

위험 요인

⚙️ 외부 명령어 (171)

🌐 네트워크 접근 (1)

skill-report.json:6

📁 파일 시스템 액세스 (4)

skill-report.json:6 templates/adr-template.md:89 workflows/synthesize.md:34 workflows/synthesize.md:42

감사자: claude 감사 이력 보기 →

품질 점수

아키텍처

100

유지보수성

콘텐츠

커뮤니티

100

보안

사양 준수

만들 수 있는 것

新しいAI支援プロジェクトを開始

コードを書く前に包括的な計画ドキュメントを生成し、AIツールが明確なアーキテクチャのコンテキストを持つようにします。

アーキテクチャの決定を文書化

根拠、検討した代替案、影響を含む主要な技術選択を記録するADRを作成します。

段階的な実装を計画

ユーザーストーリー、成功基準、明確なフェーズの依存関係を含む詳細なロードマップを構築します。

이 프롬프트를 사용해 보세요

新規プロジェクト

[ターゲットユーザー]向けに[問題]を解決する[プロジェクトタイプ]を構築したいです。/plan スキルを使用して、以下の制約でプロジェクト計画ドキュメントを生成してください:[制約をリスト]。

ドキュメントレビュー

docs/planning/内の計画ドキュメントを現在のコードベースと照らし合わせてレビューしてください。計画されたものと実装されたものの一貫性を確認してください。不一致があればフラグを立ててください。

ロードマップ更新

フェーズ[N]の[タスク]を完了しました。docs/planning/roadmap.mdを更新して、タスクを完了としてマークし、マイルストーンの進捗を更新し、次のタスクをTODOリストに追加してください。

ADR作成

[コンポーネント/機能]について技術的な決定を行う必要があります。コンテキスト、検討したオプション、下した決定、影響を文書化したADRをdocs/planning/adr/adr-[NNN]-[トピック].mdに作成してください。

모범 사례

AIアシスタントのアーキテクチャコンテキストを確立するため、コードを書く前に計画ドキュメントを生成する
次のドキュメントに進む前に、consensusツールを使用して各ドキュメントをレビューし検証する
計画と実際の実装の間の乖離を防ぐため、プロジェクトの進化に応じてドキュメントを更新する

피하기

計画をスキップし、アーキテクチャのコンテキストなしにAIにコード生成を依頼する
プロジェクト固有の正確性をレビューせずに生成されたドキュメントを使用する
実装が元の計画と異なる場合にドキュメントを更新しない

자주 묻는 질문

このスキルはプロジェクトファイルを変更しますか?

いいえ。このスキルはdocs/planning/に計画ドキュメントを生成しますが、ファイルを書き込む前にユーザーの確認が必要です。

既存のプロジェクトで使用できますか?

はい。プロジェクトの説明を提供すれば、スキルがコンテキストに基づいて適切なドキュメントを生成します。

このスキルにはどのようなツールが必要ですか?

スキルは単独で動作します。オプションで生成されたドキュメントの専門家レビューにmcp__zen__consensusを使用します。

いくつのドキュメントが生成されますか?

4つのドキュメント: プロジェクトビジョンとスコープ、技術仕様、ロードマップ、少なくとも1つのADR。

プロジェクトデータは安全ですか?

はい。すべての処理はローカルで行われます。ドキュメントは外部データ送信なしに、あなたの入力から生成されます。

他の計画ツールとの違いは何ですか?

このスキルは、Claude Codeセッション全体でコンテキストの一貫性を提供するように設計されたテンプレートを使用して、AI支援開発を特にターゲットにしています。

개발자 세부 정보

작성자

ByronWilliamsCPA

라이선스

MIT

리포지토리

https://github.com/ByronWilliamsCPA/fragrance-rater/tree/main/.claude/skills/project-planning

참조

main

파일 구조

📁 reference/

📄 document-guide.md

📄 prompting-patterns.md

📁 scripts/

📄 validate-planning-docs.py

📁 templates/

📄 adr-template.md

📄 pvs-template.md

📄 roadmap-template.md

📄 tech-spec-template.md

📁 workflows/

📄 synthesize.md

📄 SKILL.md