paw-ps-setup

Prodig Suites のセットアップ

概要

プロジェクトに Prodig Suites をインストールして設定します。Prodig Suites は、ユーザーを漠然としたアイデアから本番環境で使える製品へと導く製品作成システムです。Knowledge、Template、Software、Service の 4 つの製品ファミリーに対応しています。

このセットアップスキルでは、以下を含む完全なワークスペース構造を作成します。

• {project-root}/.pawbytes/prodig-suites/ — モジュールルート
• {project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/ — 共有メモリーサイドカー
• {project-root}/.pawbytes/prodig-suites/products/ — 製品ワークスペース
• {project-root}/.pawbytes/prodig-suites/artifacts/ — 生成された出力

設定は Pawbytes エコシステムの設定ファイルに書き込まれます。

• {project-root}/.pawbytes/config/config.yaml — モジュール固有の値を含む ps: セクションがある共有プロジェクト設定
• {project-root}/.pawbytes/config/config.user.yaml — 個人設定（user_name、communication_language）
• {project-root}/.pawbytes/config/module-help.csv — モジュールの機能を登録

{project-root} は設定値内のリテラルトークンです。実際のパスに置き換えないでください。これは、値がプロジェクトルートからの相対パスであることを、設定を使用する LLM に示します。

原則

• 適切なデフォルト値：すべての設定には妥当なデフォルト値があり、ユーザーは変更したい項目だけを上書きします
• 冪等なセットアップ：セットアップを複数回実行しても、既存の作業とメモリーは保持されます
• 明確な確認：ファイルを書き込む前に、変更内容を正確に表示します
• 段階的な情報開示：完全な内容ではなく、見出しと簡潔な説明を含むスターターファイルを作成します
• 機能の検出：任意の調査・レポート機能を確認し、不足しているものを記録します

アクティベーション時

1. モジュールのメタデータと変数定義を確認するため、./assets/module.yaml を読み込みます（code フィールドの ps はモジュール識別子です）
2. {project-root}/.pawbytes/prodig-suites/ が存在するか確認します。存在する場合は、ユーザーに更新であることを伝えます
3. {project-root}/.pawbytes/config/config.yaml に Pawbytes のコア設定があるか確認します

ユーザーが引数（例：accept all defaults、--headless、または default mode is template, quality bar is publish-ready のようなインライン値）を指定した場合は、指定された値を設定キーに対応付け、残りにはデフォルト値を使用して、対話形式での質問を省略します。それでも最後に、確認内容をすべて表示してください。

設定の収集

ユーザーに値を尋ねます。デフォルト値は角括弧で示します。すべての値をまとめて提示し、変更したい値だけを一度に回答できるようにします（例：「quality bar を publish-ready に変更、ほかはそのままで」）。チャットインターフェースではユーザーは応答するために何かを入力する必要があるため、「Enter キーを押す」や「空欄のままにする」とは決して伝えないでください。

デフォルト値の優先順位（上位が優先）：既存の設定値 > ./assets/module.yaml のデフォルト値。

コア設定（コアキーがまだ存在しない場合のみ）：user_name（デフォルト：Pawbytes）、communication_language、document_output_language（デフォルト：English — 1 つの言語の質問として尋ね、両方のキーに同じ回答を設定）。このうち、user_name と communication_language は config.user.yaml にのみ書き込みます。

モジュール設定：./assets/module.yaml の prompt フィールドがある各変数を読み込みます。そのプロンプトを使い、デフォルト値とともに尋ねます。

各設定変数の詳しい説明については、./references/config-variables.md を読み込みます。

ディレクトリ構造の作成

設定を収集した後、完全なワークスペース構造を作成します。

注： {project-root} は、実行時にプロジェクトルートディレクトリとして解決されるリテラルトークンです。実際のパスに置き換えないでください。

# Main module directories
mkdir -p "{project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/curated/product-types"
mkdir -p "{project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/daily"
mkdir -p "{project-root}/.pawbytes/prodig-suites/products"
mkdir -p "{project-root}/.pawbytes/prodig-suites/artifacts"

サイドカーファイルの作成

1. index.md（オリエンテーションファイル）の作成

{project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/index.md を作成します。

# Prodig Suites Memory Index

**Created:** {YYYY-MM-DD}
**Last Updated:** {YYYY-MM-DD}

Welcome to Prodig Suites! This is the shared memory system that maintains context across all your product creation sessions.

## Active Products

No products yet. Start your first product with:
- "I want to create a course about..."
- "Help me build a template pack for..."
- "I have an idea for a SaaS product..."
- "I want to productize my service for..."

## Recent Activity

*No activity yet — this will be populated as you work.*

## Curated Files Status

| File | Status | Description |
|------|--------|-------------|
| product-context.md | Pending | Active product definition |
| market-intelligence.md | Pending | Research synthesis |
| audience-intelligence.md | Pending | Customer insights |
| product-decisions.md | Pending | Decision history |
| output-standards.md | Ready | Quality criteria (has defaults) |

## Product Types

Prodig Suites supports four product families:

1. **Knowledge Products** — Courses, ebooks, guides, memberships
2. **Template Products** — Templates, prompt packs, digital kits
3. **Software Products** — SaaS, apps, AI tools
4. **Service Products** — Productized services, consulting packages

## How Memory Works

- **Daily files** capture session activity (chronological, append-only)
- **Curated files** hold structured knowledge (updated as you progress)
- **Index** (this file) provides quick orientation
- All agents share this memory, so context persists across sessions

## Quick Reference

| Skill | Purpose |
|-------|---------|
| paw-ps-agent-product-builder | Main coordinator — start here |
| paw-ps-discovery | Idea exploration and validation |
| paw-ps-research | Market and competitor research |
| paw-ps-audience | Customer research and personas |
| paw-ps-research-to-brief | Convert research into product brief |
| paw-ps-strategist | Product packaging and positioning |
| paw-ps-concept-to-product-plan | Transform brief into executor-ready plan |
| paw-ps-knowledge-executor | Build courses, ebooks, guides |
| paw-ps-template-executor | Build templates, prompt packs, kits |
| paw-ps-software-executor | Build SaaS, apps, AI tools |
| paw-ps-service-executor | Build productized services |
| paw-ps-product-package-assembler | Bundle into deliverable package |
| paw-ps-publish-ready-check | Evaluate production readiness |

## Getting Started

Tell me what you want to create, and I'll help you through the full journey from idea to production-ready product.

2. キュレーション済みスターターファイルの作成

各キュレーション済みファイルを、見出しと簡潔な説明を含めて作成します。

product-context.md

# Product Context

*No active product yet. This file will be populated when you start a product.*

## How to Use This File

This file captures the essential context for your active product:

- **Product Name** — Working title
- **Product Type** — Knowledge, Template, Software, or Service
- **Core Premise** — What it does and why
- **Target Audience** — Who it's for
- **Current Stage** — discovery, research, brief, execution

## Starting a Product

Tell the orchestrator:
- What product you want to create
- What type it might be (if you know)
- Who it's for (if you know)

market-intelligence.md

# Market Intelligence

*Market research will be synthesized here.*

## Purpose

Captures competitive landscape, market positioning, and opportunity signals.

## Sections (populated by research)

- **Competitive Landscape** — Who else serves this market
- **Market Gaps** — Underserved needs and opportunities
- **Positioning Signals** — How to differentiate
- **Validation Points** — Evidence of demand

audience-intelligence.md

# Audience Intelligence

*Customer insights will be synthesized here.*

## Purpose

Captures deep understanding of target customers and their needs.

## Sections (populated by research)

- **Primary Persona** — Core customer profile
- **Pain Points** — Problems they're trying to solve
- **Desired Outcomes** — What success looks like
- **Buying Triggers** — What motivates purchase
- **Language Patterns** — How they describe their problems

product-decisions.md

# Product Decisions

*Key decisions will be logged here.*

## Purpose

Tracks important decisions made during product development with context for future reference.

## Decision Log Format

| Date | Decision | Rationale | Alternatives Considered |
|------|----------|-----------|------------------------|
| | | | |

## Why This Matters

- Provides context for future iterations
- Helps explain "why did we do X?"
- Prevents revisiting settled questions

output-standards.md

# Output Standards

Quality criteria for Prodig Suites deliverables.

## Configured Quality Bar

**Current Setting:** {quality_bar from config}

### Quality Bar Definitions

| Level | Definition |
|-------|------------|
| draft | Complete structure with placeholder content |
| production-ready | Complete, no placeholders, usable by intended audience |
| publish-ready | Polished, formatted, ready for publication |
| sellable-ready | Complete, polished, ready to sell |

## Product-Type Standards

### Knowledge Products
- Clear learning objectives
- Logical progression
- Actionable content
- Complete materials

### Template Products
- Working templates
- Clear instructions
- Consistent formatting
- Reusable design

### Software Products
- Clear feature definition
- User flow documented
- Technical requirements stated
- MVP scope defined

### Service Products
- Clear offer structure
- Defined deliverables
- Scope boundaries
- Pricing logic

## Output Style

**Current Setting:** {output_style from config}

| Style | Description |
|-------|-------------|
| structured-practical | Clear sections, actionable, ready to use |
| narrative-engaging | Story-driven, conversational, engaging |
| technical-detailed | Comprehensive, thorough, documentation-heavy |

3. 製品タイプファイルを作成する

{project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/curated/product-types/ を作成します。

knowledge-products.md

# Knowledge Products

Best practices and structures for courses, ebooks, guides, and memberships.

## Product Types

### Courses
- Define learning outcomes first
- Structure in modules → lessons → topics
- Include practice activities
- Plan assessments

### Ebooks/Guides
- Define reader transformation
- Structure in chapters → sections
- Include examples and templates
- Plan call-to-actions

### Memberships
- Define content pillars
- Plan release cadence
- Structure access levels
- Design community elements

## Output Structure

```text
knowledge-product/
├── curriculum.md        # Course outline or chapter structure
├── modules/
│   ├── module-1.md
│   └── ...
├── materials/           # Supporting materials
└── assets/              # Images, downloads, etc.
```

## Quality Checklist

- [ ] Learning objectives defined
- [ ] Logical progression verified
- [ ] Practice activities included
- [ ] All content complete (no placeholders)

template-products.md

# Template Products

Best practices for templates, prompt packs, and digital kits.

## Product Types

### Templates
- Solve specific problems
- Include clear instructions
- Use placeholder conventions
- Design for reusability

### Prompt Packs
- Group by use case
- Include example outputs
- Document parameters
- Provide variation templates

### Digital Kits
- Combine complementary assets
- Provide assembly guide
- Include source files
- Document dependencies

## Output Structure

```text
template-product/
├── templates/
│   └── template-1.{ext}
├── guide.md            # Usage instructions
├── examples/           # Example outputs
└── assets/             # Supporting files
```

## Quality Checklist

- [ ] Templates are functional
- [ ] Instructions are clear
- [ ] Formatting is consistent
- [ ] Design is reusable

software-products.md

# Software Products

Best practices for SaaS, apps, and AI tools.

## Product Types

### SaaS/Apps
- Define core value proposition
- Map user journeys
- Define MVP features
- Plan technical architecture

### AI Tools
- Define AI capabilities
- Document prompts/flows
- Plan integrations
- Design user interface

## Output Structure

```text
software-product/
├── prd-lite.md         # Product requirements
├── features/
│   └── feature-1.md
├── user-flows/
│   └── flow-1.md
└── technical/
    └── architecture.md
```

## Quality Checklist

- [ ] Value proposition clear
- [ ] MVP scope defined
- [ ] User flows documented
- [ ] Technical requirements stated

service-products.md

# Service Products

Best practices for productized services and consulting packages.

## Product Types

### Productized Services
- Define clear deliverables
- Set scope boundaries
- Standardize process
- Create pricing tiers

### Consulting Packages
- Define outcomes
- Structure engagements
- Create templates
- Document process

## Output Structure

```text
service-product/
├── offer.md            # Offer structure and pricing
├── deliverables/
│   └── deliverable-1.md
├── process.md          # Delivery process
└── templates/          # Service delivery templates
```

## Quality Checklist

- [ ] Deliverables are clear
- [ ] Scope is bounded
- [ ] Pricing is defined
- [ ] Process is documented

機能を確認する

Prodig Suites を強化するオプション機能を確認します。

リサーチ機能

• Web 検索ツールが利用可能（WebSearch、mcp__exa__web_search_exa）
• コードグラフのコンテキストが利用可能（mcp__CodeGraphContext__*）

レポート機能

• プレゼンテーション生成が利用可能（paw-tools-presentation）
• リリースツールが利用可能（paw-tools-release）

確認メッセージに、利用できない機能があれば記載してください。これらはオプションですが、スイートの機能を強化します。

ファイルを書き込む

収集した回答を {"core": {...}, "module": {...}} の形式で構造化した一時 JSON ファイルを書き込みます（core がすでに存在する場合は省略します）。次に、両方のスクリプトを実行します。

python3 ./scripts/merge-config.py \
  --config-path "{project-root}/.pawbytes/config/config.yaml" \
  --user-config-path "{project-root}/.pawbytes/config/config.user.yaml" \
  --module-yaml ./assets/module.yaml \
  --answers {temp-file}

python3 ./scripts/merge-help-csv.py \
  --target "{project-root}/.pawbytes/config/module-help.csv" \
  --source ./assets/module-help.csv \
  --module-code ps

両方のスクリプトは、結果を JSON として標準出力に出力します。どちらかがゼロ以外で終了した場合は、エラーを提示して処理を停止します。

使い方の詳細は、./scripts/merge-config.py --help または ./scripts/merge-help-csv.py --help を実行してください。

確認する

スクリプトの JSON 出力を使って、書き込まれた内容（設定された構成値、config.user.yaml に書き込まれたユーザー設定（結果内の user_keys）、追加されたヘルプ項目、新規インストールか更新か）を表示します。次に、./assets/module.yaml の module_greeting をユーザーに表示します。

包括的な概要を表示します。

## Setup Complete

### Configuration
- Default product mode: {value}
- Quality bar: {value}
- Output style: {value}
- Research depth: {value}

### Created Directories
- .pawbytes/prodig-suites/memory/paw-ps-sidecar/
- .pawbytes/prodig-suites/products/
- .pawbytes/prodig-suites/artifacts/

### Created Files
- index.md — Orientation file
- product-context.md — Active product context
- market-intelligence.md — Market research synthesis
- audience-intelligence.md — Customer insights
- product-decisions.md — Decision log
- output-standards.md — Quality criteria
- product-types/*.md — Product family guides

### Capability Status
{List available/missing optional capabilities}

### What's Next
Start with `paw-ps-agent-product-builder` to create your first product.

次に、./assets/module.yaml の module_greeting を表示します。

結果

収集した入力、引数、または既存の設定からユーザーの user_name と communication_language が判明したら、セッションの残りの間は一貫してそれらを使用してください。設定された名前でユーザーに呼びかけ、設定された言語でコミュニケーションしてください。

出力仕様

セットアップが完了すると、以下が保証されます。

• アクションタイプ：モジュールのインストール／設定
• 作成されるファイル：
  • {project-root}/.pawbytes/prodig-suites/ ディレクトリ構造
  • {project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/index.md
  • {project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/curated/*.md
  • {project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/curated/product-types/*.md
  • {project-root}/.pawbytes/config/config.user.yaml（core 設定を収集した場合）
• 推奨事項：最初の製品を作成するために paw-ps-agent-product-builder の実行を提案してください
• ファイルの保存先：{project-root}/.pawbytes/prodig-suites/