sougasystem

v0.34.3

Published

2 months ago

Souga - Beauty in Autonomous Development. Complete autonomous AI development platform with GitHub OS integration. Optimized for AI coding agents (Claude Code).

0High
0Medium
0Low

norik555551

ai agents autonomous automation cli github automation workflow devops claude anthropic

双雅（ソウガ）

一つのコマンドで全てが完結する自律型AI開発フレームワーク

Autonomous AI development platform with semantic memory and context-aware orchestration

Designed for Claude Code and any AI coding agent

Quick Start | 双雅システム | Commands | HRR Memory

What's New in v0.34.x

v0.34.2 — `/souga-update` 全ユーザー対応

状態別通知: 未インストール / 古いバージョン / 最新版 / 開発者環境を自動判定して案内
一般ユーザーが /souga-update を実行すると npm install -g sougasystem@latest を自動実行

v0.34.0 — HRR意味的メモリ + コンテキスト分類エンジン

双雅システムが「引き出しを開ける知性」を獲得した。

HRR意味的メモリ — Holographic Reduced Representations による位相角ベクトル空間での意味検索
ToolRegistry — エージェントツールの自動登録・dispatch・可用性チェック
CommandDef — CLI/Discord 統一コマンド定義（7コマンド）
状況分類エンジン — 6状況（セキュリティ優先）を自動判定し最適な引き出しを選択
HRR統合 — /souga-start / /souga-save / /souga-resume / /souga-orchestrate 全コマンドが意味的文脈を活用
101テスト通過 · TypeScript 0エラー · node:sqlite built-in使用（追加依存なし）

What is 双雅？

双雅（ソウガ） は GitHub を OS として扱い、Issue → 分析 → 実装 → レビュー → PR → デプロイを自律実行するフレームワーク。

Issue → CoordinatorAgent(DAG分解) → 専門Agent群 → PR → Deploy
         ├─ IssueAgent      分析・ラベル分類
         ├─ CodeGenAgent     コード生成
         ├─ ReviewAgent      品質判定（80点以上で合格）
         ├─ PRAgent          Draft PR作成
         └─ DeploymentAgent  CI/CD・自動Rollback

v0.34.0 から、すべての実行フローが HRR意味的メモリ を通じて文脈を共有する:

souga-start  → HRR prefetch（過去の失敗パターンを先読み）
souga-orchestrate → 状況分類 → 最適引き出し選択
souga-save   → HRRファクト抽出（成功/失敗を記憶）
souga-resume → 意味的ブリーフィング（文脈復元）

Quick Start

# グローバルインストール
npm install -g sougasystem

# 既存プロジェクトに双雅を導入
npx sougasystem souga install

# バージョン確認
souga --version

# Claude Code から双雅を起動
/souga-start

3つの開発フロー

| フロー | 方法 | 向いている場面 | |--------|------|--------------| | 日本語で指示 | 「ログイン機能を追加して」と入力 | 初めて・まず試したい | | /souga-orchestrate | /souga-orchestrate bugfix メモリリーク修正 | Issueが明確・チーム運用 | | /souga-auto | /souga-auto | 未処理Issueが溜まっている |

双雅システム

セットアップ

# 現在のプロジェクトに導入（GitHub連携なし）
npx sougasystem souga install --skip-github

# GitHub連携あり（53ラベル + Actions + Projects V2）
npx sougasystem souga install

# 別のプロジェクトに展開
npx sougasystem souga install /path/to/project

# 最新版に更新
/souga-update

展開されるもの

your-project/
  CLAUDE.md                      # 双雅テンプレートから自動生成
  souga.config.json              # プロジェクト設定（言語・FW自動検出）
  .claude/
    commands/                    # スラッシュコマンド群
      souga-start.md             #   起動・HRR prefetch
      souga-orchestrate.md       #   状況分類 + Agent chain実行
      souga-save.md              #   セッション保存 + HRRファクト抽出
      souga-resume.md            #   セッション再開 + 意味的ブリーフィング
      souga-update.md            #   システム更新（状態別通知）
      souga-auto.md              #   Water Spider 全自動モード
      souga-verify.md            #   6フェーズ検証
      souga-build-fix.md         #   ビルドエラー修正
      souga-cleanup.md           #   コードクリーンアップ
      souga-security.md          #   OWASPセキュリティ
      ...（ECC 40+ コマンド含む）
    agents/                      # Agent仕様ファイル
    hooks/                       # 自動フックスクリプト
    rules/                       # コーディングルール

HRR Semantic Memory

v0.34.0で導入した意味的メモリエンジン（@agentic-os/core）。

アーキテクチャ

MemoryStore (node:sqlite + FTS5)
    ↑ addFact / recordFeedback
FactRetriever
    ├─ Stage 1: FTS5全文検索
    ├─ Stage 2: Jaccard類似度
    ├─ Stage 3: HRRコサイン類似度（位相角ベクトル空間）
    └─ Stage 4: 信頼スコア加重ソート

主要API

import { MemoryStore, FactRetriever, classifySituation, DRAWER_MAP } from '@agentic-os/core'

// ファクト保存
const store = new MemoryStore('memory.db')
store.addFact({ content: 'node:sqlite内蔵でbetter-sqlite3不要', tags: ['node', 'sqlite'], source: 'session' })

// 4段階検索
const retriever = new FactRetriever(store)
const results = retriever.search('database setup', { limit: 5, minTrust: 0.4 })

// 状況分類
const situation = classifySituation('Fix null pointer error in parser')
// → 'bugfix'
const drawers = DRAWER_MAP[situation]
// → { primary: ['superpowers:test-driven-development', ...] }

状況分類エンジン

| 状況 | トリガー例 | 推奨引き出し | |------|----------|------------| | security | auth.*vuln, XSS, 脆弱性 | security-reviewer → subagent-driven | | bugfix | バグ, fix, error | tdd-guide → subagent-driven | | refactor | リファクタリング, restructure | writing-plans → refactor-cleaner | | design | 設計, architecture | brainstorming → architect | | resume-work | resume, 前回の続き | souga-resume → subagent-driven | | new-feature | add.*feature, 機能追加 | brainstorming → writing-plans → subagent-driven |

Slash Commands (Claude Code)

双雅コア (v0.34.x)

| Command | Description | |---------|-------------| | /souga-start | 起動バナー + HRR prefetch + プロジェクト状態 | | /souga-orchestrate [pattern] [説明] | 状況分類 → Agent chain自動実行 | | /souga-save | セッション保存 + HRRファクト抽出 | | /souga-resume | セッション再開 + 意味的ブリーフィング | | /souga-update | システム更新（全ユーザー対応・状態別通知） | | /souga-auto | Water Spider 全自動モード | | /souga-verify | 6フェーズ検証パイプライン | | /souga-build-fix | ビルドエラー自動修正 | | /souga-cleanup | コードクリーンアップ（De-Sloppify） | | /souga-security | OWASP セキュリティレビュー |

`/souga-orchestrate` の使い方

/souga-orchestrate feature ログイン機能を追加
/souga-orchestrate bugfix セッションタイムアウトのバグ修正
/souga-orchestrate refactor APIクライアントの重複を統合
/souga-orchestrate security 認証トークンの脆弱性調査
/souga-orchestrate          # 入力から自動分類

`/souga-update` の動作

✅ 既に最新版です               → 通知のみ
⬆️  新しいバージョンがあります  → npm install -g sougasystem@latest を自動実行
⚠️  souga が未インストール       → インストール手順を案内
SOURCE環境（開発者）            → npm run build + npm publish

Commands Reference

プロジェクト管理

| Command | Description | |---------|-------------| | souga init <name> | 新規プロジェクト作成（GitHub repo + full setup） | | souga install | 既存プロジェクトにSougaを追加 | | souga souga install | 双雅システムを展開 | | souga souga update | 双雅システムを最新版に更新 | | souga souga eject | 双雅システムを除去 | | souga doctor | ヘルスチェック・診断 |

実行

| Command | Description | |---------|-------------| | souga run | ワンコマンド実行 | | souga fix <issue> | バグ修正 | | souga build <issue> | 機能追加 | | souga ship | デプロイ | | souga auto | Water Spider 全自動モード | | souga pipeline "..." | コマンドパイプライン |

監視

| Command | Description | |---------|-------------| | souga status | プロジェクト状態確認 | | souga status --watch | リアルタイム監視 | | souga health | クイックヘルスチェック |

Agents

Coding (11)

| Agent | 役割 | |-------|------| | CoordinatorAgent | タスク統括・DAG分解 | | CodeGenAgent | コード生成 | | ReviewAgent | コード品質判定（80点以上で合格） | | IssueAgent | Issue分析・ラベル管理 | | PRAgent | PR自動作成 | | DeploymentAgent | CI/CD・自動Rollback | | BuildFixAgent | ビルドエラー修正 | | CleanupAgent | コードクリーンアップ | | SecurityAgent | セキュリティ分析 | | LearningAgent | パターン抽出・学習 | | AnalyticsAgent | データ分析・PDCA |

Business (14)

AIEntrepreneurAgent / ContentCreationAgent / CRMAgent / FunnelDesignAgent / MarketingAgent / MarketResearchAgent / PersonaAgent / ProductConceptAgent / ProductDesignAgent / SalesAgent / SelfAnalysisAgent / SNSStrategyAgent / YouTubeAgent / CoordinatorAgent（ビジネス用）

GitHub OS Integration

双雅は GitHub をオペレーティングシステムとして扱います:

| GitHub Feature | OS Role | |---------------|---------| | Issues | Task Queue | | Labels (53) | State Machine（10カテゴリ） | | Projects V2 | Kanban Board | | Actions | Execution Engine | | Webhooks | Event Bus | | Pages | Dashboard |

Requirements

| 要件 | バージョン | |-----|---------| | Node.js | >= 18.0.0 | | Git | 最新版 | | GitHub Token | repo + workflow スコープ |

Troubleshooting

npm install -g sougasystem@latest

/souga-update
# または
npm install -g sougasystem@latest

gh auth login
# または
export GITHUB_TOKEN=ghp_your_token

npx sougasystem@latest souga install --force

License

Apache-2.0 (c) Shunsuke Hayashi

For AI Agents: Start with /souga-start in Claude Code. For JSON output use souga status --json. See AI_AGENT_USAGE.md for full API reference.