Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .cspell/framework-words.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
anthropics
75 changes: 75 additions & 0 deletions .github/workflows/claude-code-review.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
name: Claude Code Review

on:
pull_request:
types: [opened, synchronize]
# Optional: Only run on specific file changes
# paths:
# - "src/**/*.ts"
# - "src/**/*.tsx"
# - "src/**/*.js"
# - "src/**/*.jsx"

jobs:
claude-review:
# Optional: Filter by PR author
# if: |
# github.event.pull_request.user.login == 'external-contributor' ||
# github.event.pull_request.user.login == 'new-developer' ||
# github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'

runs-on: ubuntu-latest
permissions:
contents: read
pull-requests: read
issues: read
id-token: write

steps:
- name: Checkout repository
uses: actions/checkout@v4
with:
fetch-depth: 1

- name: Run Claude Code Review
id: claude-review
uses: anthropics/claude-code-action@beta
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

# Optional: Specify model (defaults to Claude Sonnet 4, uncomment for Claude Opus 4)
# model: "claude-opus-4-20250514"

# Direct prompt for automated review (no @claude mention needed)
direct_prompt: |
Please review this pull request and provide feedback on:
- Code quality and best practices
- Potential bugs or issues
- Performance considerations
- Security concerns
- Test coverage

Be constructive and helpful in your feedback.

# Optional: Customize review based on file types
# direct_prompt: |
# Review this PR focusing on:
# - For TypeScript files: Type safety and proper interface usage
# - For API endpoints: Security, input validation, and error handling
# - For React components: Performance, accessibility, and best practices
# - For tests: Coverage, edge cases, and test quality

# Optional: Different prompts for different authors
# direct_prompt: |
# ${{ github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR' &&
# 'Welcome! Please review this PR from a first-time contributor. Be encouraging and provide detailed explanations for any suggestions.' ||
# 'Please provide a thorough code review focusing on our coding standards and best practices.' }}

# Optional: Add specific tools for running tests or linting
# allowed_tools: "Bash(npm run test),Bash(npm run lint),Bash(npm run typecheck)"

# Optional: Skip review for certain conditions
# if: |
# !contains(github.event.pull_request.title, '[skip-review]') &&
# !contains(github.event.pull_request.title, '[WIP]')

60 changes: 60 additions & 0 deletions .github/workflows/claude.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
name: Claude Code

on:
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
issues:
types: [opened, assigned]
pull_request_review:
types: [submitted]

jobs:
claude:
if: |
(github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
(github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
runs-on: ubuntu-latest
permissions:
contents: read
pull-requests: read
issues: read
id-token: write
steps:
- name: Checkout repository
uses: actions/checkout@v4
with:
fetch-depth: 1

- name: Run Claude Code
id: claude
uses: anthropics/claude-code-action@beta
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
timeout_minutes: "30"

# Optional: Specify model (defaults to Claude Sonnet 4, uncomment for Claude Opus 4)
# model: "claude-opus-4-20250514"

# Optional: Customize the trigger phrase (default: @claude)
# trigger_phrase: "/claude"

# Optional: Trigger when specific user is assigned to an issue
# assignee_trigger: "claude-bot"

# Optional: Allow Claude to run specific commands
# allowed_tools: "Bash(npm install),Bash(npm run build),Bash(npm run test:*),Bash(npm run lint:*)"

# Optional: Add custom instructions for Claude to customize its behavior for your project
# custom_instructions: |
# Follow our coding standards
# Ensure all new code has tests
# Use TypeScript for new files

# Optional: Custom environment variables for Claude
# claude_env: |
# NODE_ENV: test

15 changes: 15 additions & 0 deletions .vscode/settings.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,13 @@
"addWords": true,
"scope": "workspace"
},
"framework-words": {
"name": "framework-words",
"path": "${workspaceRoot}/.cspell/framework-words.txt",
"description": "Framework Specific Words",
"addWords": true,
"scope": "workspace"
},
"organization-words": {
"name": "organization-words",
"path": "${workspaceRoot}/.cspell/organization-words.txt",
Expand Down Expand Up @@ -48,5 +55,13 @@
"**/bower_components": true,
"**/*.code-search": true,
"public": true
},
"workbench.colorCustomizations": {
"titleBar.activeBackground": "#EEEEEE",
"titleBar.activeForeground": "#333333",
"titleBar.inactiveBackground": "#CCCCCC",
"titleBar.inactiveForeground": "#666666",
"statusBar.debuggingBackground": "#FFFFFF",
"statusBar.debuggingForeground": "#000000"
}
}
99 changes: 99 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
# CLAUDE.md

## 概要

このプロジェクトは Altive Handbook - Hugo と Docsy テーマで構築された会社のドキュメントサイトです。

このハンドブックは、公開可能なすべての会社全体の情報の Single Source of Truth (SSOT) として機能します。日本語コンテンツ(`content/ja/`)を対象とし、会社のポリシー、エンジニアリングプラクティス、オンボーディング、ジョブファミリー等を網羅する包括的なドキュメントシステムとして構造化されています。

### 主要コンポーネント

- **Hugo Static Site Generator**: 多言語サポート(主に日本語)でサイトを動作させる
- **Docsy テーマ**: UI フレームワークを提供する Google のドキュメントテーマ
- **コンテンツ構造**: 階層的なドキュメントセクションで `content/ja/` 配下に整理
- **デプロイ**: GitHub Actions により main ブランチプッシュ時に GitHub Pages へ自動デプロイ

### コンテンツ構成

ハンドブックは以下の主要セクションに整理されています:
- `company/`: 会社のポリシー、価値観、ミッション、福利厚生
- `engineering/`: 開発プラクティス、コードルール、Flutter/Git ガイドライン
- `onboarding/`: 新入社員向けガイドと手順
- `job-families/`: 役職定義とキャリア進路
- `communication/`: 会議プロトコルとコミュニケーションガイドライン
- `handbook/`: ハンドブック自体に関するメタドキュメント

## 開発コマンド

### 初期セットアップ
```bash
# Hugo をインストール(必須)
brew install hugo

# Go をインストール(Hugo モジュールに必須)
brew install go

# npm の依存関係をインストール
npm install
```

### 開発サーバー
```bash
# ライブリロード付きで開発サーバーを起動
hugo server

# ドラフトコンテンツを含める
hugo server -D

# 変更されたファイルに自動ナビゲート
hugo server --navigateToChanged
```

### コンテンツ作成
```bash
# 新しいコンテンツページを作成
hugo new content directory/page-name.md
```

### ビルドコマンド
```bash
# 開発用にビルド
npm run build

# 本番用にビルド
npm run build:production

# ビルド成果物をクリーン
npm run clean
```

### テスト
```bash
# リンクチェックを実行(ビルド後)
npm test
```

## コンテンツガイドライン

### Front Matter フォーマット
一貫性のため YAML front matter を使用(TOML や JSON ではなく):

```yaml
---
title: "ページタイトル" # 必須
description: "ページの説明" # 推奨
linkTitle: "短いタイトル" # オプション
slug: "カスタム-url-スラッグ" # オプション
---
```

### 言語とローカライゼーション
- 主要言語: 日本語(`ja`)
- コンテンツは `content/ja/` に配置
- Hugo は CJK 言語サポートで設定済み
- すべてのコンテンツに「なぜ」を明確に含める

### デプロイ
- main ブランチプッシュ時に GitHub Actions による自動デプロイ
- 本番サイト: https://handbook.altive.co.jp
- プレビュー用の Netlify デプロイもサポート
Loading