← ドキュメント一覧/はじめに

Getting Started - 入門ガイド

Getting Started - 入門ガイド

概要: Autonomous-Operationsプロジェクトを初めて使う方のための入門ガイドです。5分でプロジェクトの概要を理解し、環境構築を完了できます。

対象読者: 初心者 所要時間: 30分 前提知識: Git、Node.js、GitHub の基本的な知識

目次

  1. セクション概要
  2. 5分クイックスタート
  3. このセクションで学べること
  4. ドキュメント一覧
  5. 推奨読書順序
  6. 次のステップ

セクション概要

Getting Startedセクションでは、以下の内容をカバーしています:

  • クイックスタート: 5分でプロジェクトを動かす
  • 基本コンセプト: プロジェクトの核となる概念の理解
  • セットアップガイド: 詳細な環境構築手順

このセクションを完了すると、プロジェクトの全体像を理解し、自分の環境でAgentを実行できるようになります。

5分クイックスタート

Step 1: プロジェクト初期化 (2分)

# NPMパッケージからプロジェクト初期化
npx agentic-os init my-project

# ディレクトリ移動
cd my-project

# GitHub Token設定 (環境変数)
export GITHUB_TOKEN="ghp_your_token_here"

Step 2: Issue作成 (30秒)

# 新しいIssueを作成
gh issue create --title "Add login page" \
  --body "ユーザーログインページを追加してください"

Step 3: AI自動実行 (2分)

Issueを作成すると、AIが自動で以下を実行します:

  1. 自動ラベリング: Issue内容を分析して適切なラベルを付与
  2. Agent割り当て: CodeGenAgentなど最適なAgentを自動選択
  3. 実装: AIがコード生成、テスト作成、品質チェック
  4. PR作成: 完成したコードをPull Requestとして提出

完了時間: 約2分

このセクションで学べること

1. プロジェクトの目的

Autonomous-Operationsは、人間介入を最小化する完全自律型AI開発オペレーションを実現するプラットフォームです。

主要達成指標:

  • AI Task成功率: 97%
  • 平均実行時間: 3分
  • 時間削減: 83% (240分→40分)

2. コアコンセプト

  • 6-Agent階層システム: 役割分担された6種類のAgent
  • 並行実行: DAGベースの依存関係解決と並行タスク実行
  • GitHub as OS: GitHub全15機能をOS Componentsとして統合
  • 組織設計原則5原則: データ駆動型の意思決定フレームワーク

3. 基本的な使い方

  • CLI コマンドの実行
  • Issueの作成と管理
  • Agentの実行と監視
  • 品質スコアの確認

ドキュメント一覧

このセクションには以下のドキュメントが含まれます:

0. claude-code-setup.md ⭐ まずはここから！

内容: Claude Code 環境準備 - Autonomous-Operationsを使う前の必須ステップ 所要時間: 10分 こんな方におすすめ: 初めてClaude Codeを使う方、環境準備が必要な方

🚨 重要: Autonomous-Operationsは Claude Code 上で動作します。まずこのドキュメントで環境を準備してください。

1. quickstart.md

内容: 5分でプロジェクトを動かす最速ガイド 所要時間: 5分 こんな方におすすめ: とにかく早く動かしてみたい方 前提: Claude Code がインストール済み

2. concepts.md

内容: プロジェクトの基本コンセプトと用語解説 所要時間: 15分 こんな方におすすめ: プロジェクトの設計思想を理解したい方

3. setup-guide.md

内容: 詳細な環境構築手順とトラブルシューティング 所要時間: 30分 こんな方におすすめ: 本番環境を構築したい方

推奨読書順序

⭐ 初めての方 (所要時間: 40分)

必ず順番通りに読んでください:

  1. claude-code-setup.md (10分) ⬅️ 最初に必読！

    • Claude Code環境をインストール・設定
    • これがないと何も動きません

  2. quickstart.md (5分)

    • まず動かしてみて、プロジェクトの雰囲気を掴む

  3. concepts.md (15分)

    • 6-Agent階層、並行実行、GitHub as OSなどの基本概念を理解

  4. setup-guide.md (10分)

    • 詳細な設定を確認し、環境を最適化

急いでいる方 (所要時間: 15分)

  1. claude-code-setup.md (10分) ⬅️ スキップ不可

    • 環境準備は必須です

  2. quickstart.md (5分)

    • 5分でプロジェクトを動かし、後で詳細を学ぶ

じっくり学びたい方 (所要時間: 1.5時間)

  1. claude-code-setup.md (10分) ⬅️ 最初に必読！

    • まず基盤となる環境を準備

  2. concepts.md (15分)

    • 概念を理解する

  3. quickstart.md (5分)

    • 概念を理解した上で実行すると、より深く学べる

  4. setup-guide.md (30分)

    • 詳細な設定を一つずつ確認

  5. ../03-guides/cli-usage.md (10分)

    • 次のステップとしてCLI使用方法を学ぶ

よくある質問

Q1: 前提知識は何が必要ですか?

A: 以下の基本的な知識があれば大丈夫です:

  • Git の基本操作 (clone、commit、push)
  • Node.js / NPM の基本 (npm install、npm run)
  • GitHub の基本 (Issue、Pull Request)
  • コマンドラインの基本操作

Q2: セットアップにどのくらい時間がかかりますか?

A: 環境によりますが、以下が目安です:

  • クイックスタート: 5分
  • 基本セットアップ: 10-15分
  • 完全セットアップ: 30分

Q3: エラーが出た場合はどうすればいいですか?

A: setup-guide.md のトラブルシューティングセクションを参照してください。

それでも解決しない場合は:

  1. トラブルシューティングガイド
  2. GitHubのIssues
  3. Discordコミュニティ

Q4: Windows/Mac/Linuxどれでも動きますか?

A: はい、すべてのOSで動作します。ただし、以下の環境が必要です:

  • Node.js 16以上
  • Git 2.20以上
  • GitHub CLI (gh)

学習の進め方

このセクション完了後の理解度チェック

以下の質問に答えられれば、次のセクションに進む準備ができています:

  • プロジェクトの主要な目的を説明できる
  • 6種類のAgentの役割を理解している
  • 基本的なCLIコマンドを実行できる
  • Issueを作成してAgentを実行できる
  • 品質スコアの意味を理解している

次のステップ

レベル2: 実践的な使い方を学ぶ

Getting Startedセクションを完了したら、次は実践編に進みましょう:

  1. CLI使用ガイド

    • より高度なコマンドの使い方
    • 並行実行の方法
    • デバッグモードの使い方

  2. Agent実行ガイド

    • 各Agentの詳細な使い方
    • Agentのカスタマイズ方法
    • エスカレーション処理

  3. テストガイド

    • テスト戦略の理解
    • E2Eテストの実行
    • カスタムテストの作成

レベル3: アーキテクチャを理解する

システムの内部構造を深く理解したい場合:

  1. システム全体像
  2. Agent階層システム
  3. 並行実行アーキテクチャ

関連ドキュメント

同レベル

次のレベル

リファレンス

フィードバック

このセクションについて改善提案がある場合は、GitHub Issues または Discord でお知らせください。

作成日: 2025-10-10 更新日: 2025-10-10 メンテナー: Autonomous-Operations Team

← ドキュメント一覧ホームへ →