shirokuma-docs 0.1.0-alpha.1

package/plugin/shirokuma-skills-ja/skills/project-config-generator/templates/discussion-templates/ja/knowledge.yml

@@ -0,0 +1,66 @@
+title: ""
+labels: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## 技術知見
+        確定した技術的知見・パターンを記録します。
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: 問題
+      description: どんな問題を解決するか
+      placeholder: |
+        Radix UI コンポーネントでハイドレーションエラーが発生する
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: 解決策
+      description: 確定した解決策
+      placeholder: |
+        `mounted` state パターンを使用する
+    validations:
+      required: true
+
+  - type: textarea
+    id: example
+    attributes:
+      label: 例
+      description: コード例
+      render: typescript
+      placeholder: |
+        const [mounted, setMounted] = useState(false)
+        useEffect(() => { setMounted(true) }, [])
+
+        if (!mounted) return <Placeholder />
+        return <RadixComponent />
+
+  - type: textarea
+    id: when-to-use
+    attributes:
+      label: 適用タイミング
+      description: この知見を適用すべき状況
+      placeholder: |
+        - DropdownMenu, Select, Collapsible などの Radix UI コンポーネント使用時
+        - SSR 環境で ID 不一致エラーが出る場合
+
+  - type: textarea
+    id: references
+    attributes:
+      label: 参照
+      description: 関連するドキュメント、Issue、Discussion
+      placeholder: |
+        - Issue #XX で発見
+        - https://github.com/radix-ui/primitives/issues/XXX
+
+  - type: input
+    id: related-rule
+    attributes:
+      label: 関連ルール
+      description: 対応する .claude/rules/ ファイル（あれば）
+      placeholder: .claude/rules/radix-ui.md

package/plugin/shirokuma-skills-ja/skills/project-config-generator/templates/discussion-templates/ja/research.yml

@@ -0,0 +1,71 @@
+title: ""
+labels: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## 調査依頼
+        調査依頼・調査結果を記録します。
+
+  - type: textarea
+    id: question
+    attributes:
+      label: 質問
+      description: 調査したい内容
+      placeholder: |
+        Drizzle ORM で soft delete を実装するベストプラクティスは？
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: 背景
+      description: なぜこの調査が必要か
+      placeholder: |
+        ユーザーデータの削除時に物理削除ではなく論理削除を実装したい。
+        関連: Issue #XX
+
+  - type: textarea
+    id: scope
+    attributes:
+      label: スコープ
+      description: 調査の範囲・観点
+      placeholder: |
+        - Drizzle ORM 公式ドキュメント
+        - 既存プロジェクトの実装例
+        - パフォーマンスへの影響
+
+  - type: textarea
+    id: findings
+    attributes:
+      label: 調査結果
+      description: 調査結果（調査完了後に更新）
+      placeholder: |
+        *調査中...*
+
+        ---
+        **調査完了後:**
+        1. 方法A: ...
+        2. 方法B: ...
+
+  - type: textarea
+    id: conclusion
+    attributes:
+      label: 結論
+      description: 結論・推奨事項
+      placeholder: |
+        **推奨**: 方法A を採用
+
+        理由: ...
+
+  - type: checkboxes
+    id: next-actions
+    attributes:
+      label: 次のアクション
+      description: 調査後のアクション
+      options:
+        - label: ADR を作成する（決定が必要な場合）
+        - label: Knowledge を作成する（パターンが確定した場合）
+        - label: Issue を作成する（実装が必要な場合）
+        - label: Rule を作成/更新する（AI 用の抽出）

package/plugin/shirokuma-skills-ja/skills/project-config-generator/templates/github-discussions.md.template

@@ -0,0 +1,161 @@
+# GitHub Discussions Setup
+
+## Required Categories
+
+Configure at: `https://github.com/{owner}/{repo}/discussions/categories`
+
+Click "New category" to add each category.
+
+| Category | Icon | Format | Description |
+|----------|------|--------|-------------|
+| **Handovers** | 🔄 | Announcement | Session handover notes - AI session continuity |
+| **ADR** | 📐 | Announcement | Architecture Decision Records - Design decisions |
+| **Knowledge** | 💡 | Announcement | Technical knowledge and patterns - Confirmed solutions |
+| **Research** | 🔬 | Open-ended | Research requests and findings - Discussion format |
+
+## Category Details
+
+### Handovers 🔄
+
+**Format**: Announcement (no replies needed)
+**Purpose**: Session continuity between AI coding sessions
+
+**Title format**: `YYYY-MM-DD - {summary}`
+
+**Body template**:
+```markdown
+## Summary
+{What was accomplished}
+
+## Related Items
+- Issue #{n}: {title} → {status}
+
+## Key Decisions
+{Important decisions made}
+
+## Blockers
+{Current blockers or "None"}
+
+## Next Steps
+- [ ] {Next action item}
+
+## Modified Files
+- `path/to/file.ts` - {change description}
+
+## Commits
+- `{hash}` {message}
+```
+
+### ADR 📐
+
+**Format**: Announcement (decisions are final)
+**Purpose**: Record architecture decisions with context
+
+**Title format**: `ADR-{NNN}: {decision title}`
+
+**Body template**:
+```markdown
+## Status
+{Proposed | Accepted | Deprecated | Superseded by ADR-XXX}
+
+## Context
+{What is the issue that we're seeing that is motivating this decision?}
+
+## Decision
+{What is the change that we're proposing and/or doing?}
+
+## Consequences
+{What becomes easier or more difficult because of this change?}
+
+## Alternatives Considered
+{Other options that were evaluated}
+```
+
+### Knowledge 💡
+
+**Format**: Announcement (confirmed knowledge)
+**Purpose**: Document patterns, solutions, and best practices
+
+**Title format**: `{Topic or Pattern Name}`
+
+**Body template**:
+```markdown
+## Problem
+{What issue does this solve?}
+
+## Solution
+{The confirmed solution or pattern}
+
+## Example
+```{language}
+{Code example}
+```
+
+## References
+- Issue #{n} (where this was discovered)
+- External docs: {URL}
+
+## Related Rules
+- `.claude/rules/{rule-name}.md`
+```
+
+### Research 🔬
+
+**Format**: Open-ended (allows discussion)
+**Purpose**: Investigation requests and findings
+
+**Title format**: `[Research] {topic}`
+
+**Body template**:
+```markdown
+## Question
+{What needs to be researched?}
+
+## Context
+{Why is this research needed?}
+
+## Scope
+- {Specific aspect 1}
+- {Specific aspect 2}
+
+## Findings
+{Updated as research progresses}
+
+## Conclusion
+{Final recommendation or decision}
+
+## Next Steps
+- [ ] Create ADR if decision needed
+- [ ] Create Knowledge if pattern confirmed
+- [ ] Create Issue if action needed
+```
+
+## Usage Flow
+
+```
+Research (investigation)
+    ↓
+ADR (if decision needed)
+    ↓
+Knowledge (confirmed pattern)
+    ↓
+.claude/rules/ (AI-readable extract)
+```
+
+## Integration with Issues/Projects
+
+Discussions can be added to Projects:
+```bash
+gh project item-add PROJECT_ID --url DISCUSSION_URL
+```
+
+Cross-reference in Issues:
+```markdown
+See Discussion #30 for background research.
+```
+
+## Notes
+
+- Discussions use same number space as Issues (#1, #2, ...)
+- Cross-references work: "See #30" links to Discussion or Issue
+- Projects can track both Issues and Discussions

package/plugin/shirokuma-skills-ja/skills/project-config-generator/templates/known-issues.md.template

@@ -0,0 +1,54 @@
+# Known Issues
+
+CVEs, bugs, and workarounds for the current tech stack.
+
+## Active Issues
+
+### High Priority
+
+| Issue | Affected | Workaround | Status |
+|-------|----------|------------|--------|
+| (none) | - | - | - |
+
+<!-- Example row:
+| CVE-2024-XXXXX | package-name@1.0.0 | Upgrade to 1.0.1 | Monitoring |
+-->
+
+### Medium Priority
+
+| Issue | Affected | Workaround | Status |
+|-------|----------|------------|--------|
+| - | - | - | - |
+
+## Resolved Issues
+
+| Issue | Resolution Date | Solution |
+|-------|-----------------|----------|
+| - | - | - |
+
+## Framework-Specific
+
+### Next.js
+
+- Check: https://github.com/vercel/next.js/security/advisories
+
+### Better Auth
+
+- Check: https://github.com/better-auth/better-auth/security
+
+### Drizzle ORM
+
+- Check: https://github.com/drizzle-team/drizzle-orm/issues
+
+## Update Schedule
+
+- Weekly: Check for new CVEs
+- Monthly: Review and update this document
+- On dependency update: Verify no new issues
+
+## How to Add Issues
+
+1. Add to appropriate priority section
+2. Include workaround if available
+3. Link to CVE or GitHub issue
+4. Update status as resolved

package/plugin/shirokuma-skills-ja/skills/project-config-generator/templates/lib-structure.md.template

@@ -0,0 +1,73 @@
+# lib/ Directory Structure
+
+Project-specific conventions for organizing the `lib/` directory.
+
+## Structure
+
+```
+lib/
+├── actions/           # Server Actions (CRUD operations)
+│   ├── crud/          # Basic CRUD by domain
+│   │   ├── users.ts
+│   │   └── posts.ts
+│   └── workflows/     # Complex multi-step operations
+├── context/           # React Context providers
+├── hooks/             # Custom React hooks
+├── utils/             # Pure utility functions
+├── validations/       # Zod schemas
+└── types/             # TypeScript type definitions
+```
+
+## Conventions
+
+### Server Actions (`lib/actions/`)
+
+```typescript
+/**
+ * @serverAction
+ * @description Creates a new resource
+ * @param {FormData} formData - Form data
+ * @returns {Promise<ActionResult<Resource>>} Created resource
+ */
+export async function createResource(formData: FormData): Promise<ActionResult<Resource>> {
+  const { user } = await auth()  // 1. Auth check
+  if (!user) return { error: "Unauthorized" }
+
+  await verifyCsrfToken(formData)  // 2. CSRF
+
+  const validated = schema.safeParse(...)  // 3. Validation
+  if (!validated.success) return { error: validated.error }
+
+  // 4. Business logic
+  const result = await db.insert(...)
+
+  revalidatePath("/resources")  // 5. Revalidate
+  return { data: result }
+}
+```
+
+### Hooks (`lib/hooks/`)
+
+- Prefix with `use`: `useAuth`, `useTheme`
+- One hook per file
+- Include JSDoc with usage example
+
+### Utils (`lib/utils/`)
+
+- Pure functions only (no side effects)
+- Well-typed with generics where applicable
+- Include unit tests
+
+### Validations (`lib/validations/`)
+
+- One schema file per domain
+- Export both schema and inferred type
+- Use `.refine()` for custom validations
+
+## Anti-Patterns
+
+| Bad | Good | Reason |
+|-----|------|--------|
+| `lib/helpers.ts` | `lib/utils/string.ts` | Too generic |
+| `lib/api.ts` | `lib/actions/` | Use Server Actions |
+| `lib/data.ts` | `lib/actions/crud/` | Unclear purpose |

package/plugin/shirokuma-skills-ja/skills/project-config-generator/templates/tech-stack.md.template

@@ -0,0 +1,51 @@
+# Tech Stack Reference
+
+Current versions and patterns for this project.
+
+## Versions
+
+| Category | Technology | Version |
+|----------|------------|---------|
+| Framework | Next.js | {{NEXTJS_VERSION}} |
+| UI Library | React | {{REACT_VERSION}} |
+| Language | TypeScript | {{TYPESCRIPT_VERSION}} |
+| Database | Drizzle ORM | {{DRIZZLE_VERSION}} |
+| Auth | Better Auth | {{BETTER_AUTH_VERSION}} |
+| i18n | next-intl | {{NEXT_INTL_VERSION}} |
+| Styling | Tailwind CSS | {{TAILWIND_VERSION}} |
+| Components | shadcn/ui | {{SHADCN_VERSION}} |
+| Testing | Jest | {{JEST_VERSION}} |
+| E2E | Playwright | {{PLAYWRIGHT_VERSION}} |
+
+## Key Patterns
+
+### Server Actions
+- Location: `lib/actions/`
+- Pattern: `"use server"` + auth check + CSRF + Zod validation
+
+### Components
+- UI primitives: `components/ui/` (shadcn)
+- Feature components: `components/{feature}/`
+
+### Database
+- Schema: `packages/database/src/schema/`
+- Migrations: Drizzle Kit
+
+### i18n
+- Languages: {{SUPPORTED_LANGUAGES}}
+- Messages: `messages/{locale}/`
+
+## Version-Specific Notes
+
+### Tailwind CSS v4
+- CSS variables require `var()` wrapper: `[var(--color)]`
+- Run fix script after shadcn additions
+
+### React 19
+- Server Components by default
+- `use client` directive required for client-only code
+
+### Better Auth
+- Passwords stored in `accounts` table
+- Session-based authentication
+- Post-login redirect: use `window.location.href`

package/plugin/shirokuma-skills-ja/skills/publishing/SKILL.md

@@ -0,0 +1,227 @@
+---
+name: publishing
+description: shirokuma-docs repo-pairs CLIを使用して公開リリースを管理します。ステータスチェック、ドライランプレビュー、リリース実行、.shirokumaignore設定を処理します。
+allowed-tools: Bash, Read, Grep, Glob, AskUserQuestion, TodoWrite
+---
+
+# パブリッシング
+
+`shirokuma-docs repo-pairs` CLI で Private → Public リポジトリへのリリースを管理。
+
+## いつ使うか
+
+以下の場合に自動起動:
+- "publish" や "release" で公開リポに反映したい場合
+- "公開リポに反映", "パブリックに出して", "リリースして"
+- リリース状況や公開リポとの差分を確認したい場合
+- "repo-pairs", ".shirokumaignore", 公開リポ同期に言及した場合
+
+## 前提条件
+
+- `shirokuma-docs` CLI が PATH で利用可能
+- `gh` CLI 認証済み（`gh auth status`）
+- `shirokuma-docs.config.yaml` がプロジェクトルートに存在
+- リポジトリペアが設定済み（`shirokuma-docs repo-pairs list`）
+
+## CLI リファレンス
+
+### コアコマンド
+
+```bash
+# 設定済みリポペア一覧
+shirokuma-docs repo-pairs list
+
+# リリース状況確認（両リポの最新タグ）
+shirokuma-docs repo-pairs status <alias>
+
+# リリースプレビュー（変更なし）
+shirokuma-docs repo-pairs release <alias> --tag <version> --dry-run
+
+# リリース実行
+shirokuma-docs repo-pairs release <alias> --tag <version>
+
+# デバッグ用の詳細出力
+shirokuma-docs repo-pairs release <alias> --tag <version> -v
+```
+
+### 新しいリポペアの初期化
+
+```bash
+shirokuma-docs repo-pairs init <alias> \
+  --private <owner/repo> \
+  --public <owner/repo> \
+  --exclude ".claude/" --exclude "docs/internal/"
+```
+
+設定は `shirokuma-docs.config.yaml` に保存される。
+
+## ワークフロー
+
+### ステップ 1: リリース前チェック
+
+リリース前に以下のチェックを実行:
+
+```bash
+# 1. クリーンな作業ディレクトリを確認
+git status
+
+# 2. 現在のリリース状況確認
+shirokuma-docs repo-pairs status <alias>
+
+# 3. 除外対象を確認
+cat .shirokumaignore
+
+# 4. リリースプレビュー
+shirokuma-docs repo-pairs release <alias> --tag <version> --dry-run
+```
+
+ユーザーに報告:
+- 現在の公開バージョン（最新タグ）
+- 提案する新バージョン
+- 除外されるファイル
+- 未コミット変更（あれば先にコミットが必要）
+
+### ステップ 2: バージョン決定
+
+`AskUserQuestion` でバージョン番号をユーザーに確認。
+
+セマンティックバージョニングに従う:
+
+| 変更の種類 | バンプ | 例 |
+|-----------|--------|-----|
+| 破壊的変更 | メジャー | v1.0.0 → v2.0.0 |
+| 新スキル/ルール、新機能 | マイナー | v0.1.0 → v0.2.0 |
+| バグ修正、タイポ修正 | パッチ | v0.1.0 → v0.1.1 |
+
+前回リリースからの変更に基づきバージョンを提案:
+
+```bash
+# 前回タグからのコミット確認（Private リポ）
+git log $(git describe --tags --abbrev=0 2>/dev/null || echo "HEAD~10")..HEAD --oneline
+
+# Private にタグがない場合、Public リポの最新タグを確認
+shirokuma-docs repo-pairs status <alias>
+```
+
+### ステップ 3: リリース実行
+
+```bash
+shirokuma-docs repo-pairs release <alias> --tag <version>
+```
+
+CLI の処理内容:
+1. Private リポを一時ディレクトリにクローン
+2. `.shirokumaignore` と `--exclude` パターンに該当するファイルを除外
+3. `.shirokumaignore` 自体と `.claude/`（デフォルト除外）を除外
+4. Public リポにタグ付きでプッシュ
+
+### ステップ 4: リリース後検証
+
+```bash
+# リリースタグを検証
+shirokuma-docs repo-pairs status <alias>
+
+# GitHub API で公開リポの内容を確認
+gh repo view <public-owner/repo> --json description
+gh api repos/<public-owner/repo>/git/trees/main?recursive=1 -q '.tree[].path' | head -30
+```
+
+ユーザーに報告:
+- 作成されたリリースタグ
+- 公開リポ URL
+- 公開リポのファイル数
+
+## ファイル除外
+
+### .shirokumaignore
+
+公開リリースから除外するパターンを記述する gitignore 構文ファイル。
+
+```
+# 開発用設定
+CLAUDE.md
+shirokuma-docs.config.yaml
+
+# リポ固有の CI/テンプレート
+.github/
+```
+
+### デフォルト除外（CLI が常時適用）
+
+| パターン | 理由 |
+|---------|------|
+| `.shirokumaignore` | メタファイル、公開不要 |
+| `.claude/` | プロジェクト固有の AI 設定 |
+| `.mcp.json` | ローカル MCP サーバー設定 |
+
+### 設定経由の除外（repo-pairs init）
+
+`repo-pairs init` 時に設定したパターンは設定に保存され常時適用:
+
+```bash
+shirokuma-docs repo-pairs list  # 設定済みの除外パターンを表示
+```
+
+## エラーハンドリング
+
+| エラー | 原因 | 修正 |
+|-------|------|------|
+| `repo pair not found` | エイリアス未設定 | `repo-pairs init` を実行 |
+| `tag already exists` | バージョンリリース済み | バージョンを上げる |
+| `working directory not clean` | 未コミット変更あり | コミットまたは stash |
+| `authentication failed` | gh 未ログイン | `gh auth login` を実行 |
+| `public repo not found` | リポ未作成 | GitHub でリポを先に作成 |
+| `.shirokumaignore not supported` | CLI バージョンが古い | 手動ワークフロー（下記）を使用 |
+
+## 手動ワークフロー（フォールバック）
+
+`repo-pairs release` が失敗した場合、または `.shirokumaignore` が未サポートの場合:
+
+```bash
+ALIAS="<alias>"
+PUBLIC_REPO="<owner/repo>"
+VERSION="<version>"
+
+TMPDIR=$(mktemp -d)
+rsync -a \
+  --exclude='.git' \
+  --exclude='.claude/' \
+  --exclude='.github/' \
+  --exclude='.shirokumaignore' \
+  --exclude='CLAUDE.md' \
+  --exclude='shirokuma-docs.config.yaml' \
+  --exclude='.mcp.json' \
+  "$(pwd)/" "$TMPDIR/"
+
+cd "$TMPDIR"
+git init && git add -A
+git commit -m "$VERSION: Release"
+git tag "$VERSION"
+git remote add origin "git@github.com:$PUBLIC_REPO.git"
+git push -u origin main --tags --force
+cd - && rm -rf "$TMPDIR"
+```
+
+**重要**: `--force` プッシュ前に必ずユーザーに確認。
+
+## 注意事項
+
+- `TodoWrite` で進捗管理（4ステップ）
+- ドライラン（`--dry-run`）なしでリリースを実行しない
+- 作業ディレクトリがクリーンでない状態でリリースしない
+
+## クイックコマンド
+
+```bash
+# 状況確認
+"release status" / "リリース状況確認"
+
+# ドライラン
+"preview release" / "リリースプレビュー"
+
+# 実行
+"release v0.2.0" / "v0.2.0 をリリース"
+
+# フルワークフロー
+"publish to public repo" / "パブリックに反映"
+```