{"id":31581109,"url":"https://github.com/itdojp/ae-framework","last_synced_at":"2025-10-05T21:53:38.137Z","repository":{"id":309274474,"uuid":"1035152820","full_name":"itdojp/ae-framework","owner":"itdojp","description":"AI-enhanced development framework that turns natural language into formal specs and production-grade code with agentic pipelines and quality gates.","archived":false,"fork":false,"pushed_at":"2025-10-03T16:38:16.000Z","size":6134,"stargazers_count":1,"open_issues_count":57,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-03T18:42:29.472Z","etag":null,"topics":["ai","ai-agent","ci-cd","code-generation","domain-driven-design","formal-specification","mcp","model-based-testing","open-policy-agent","opentelemetry","requirements-engineering","runtime-verification","ssot","tdd"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/itdojp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":"GOVERNANCE.md","roadmap":"docs/roadmap/TESTING-DDD-INDEX.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-08-09T19:07:11.000Z","updated_at":"2025-10-01T23:50:57.000Z","dependencies_parsed_at":"2025-09-25T07:25:00.068Z","dependency_job_id":null,"html_url":"https://github.com/itdojp/ae-framework","commit_stats":null,"previous_names":["itdojp/ae-framework"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/itdojp/ae-framework","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itdojp%2Fae-framework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itdojp%2Fae-framework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itdojp%2Fae-framework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itdojp%2Fae-framework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itdojp","download_url":"https://codeload.github.com/itdojp/ae-framework/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itdojp%2Fae-framework/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278526242,"owners_count":26001325,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-05T02:00:06.059Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agent","ci-cd","code-generation","domain-driven-design","formal-specification","mcp","model-based-testing","open-policy-agent","opentelemetry","requirements-engineering","runtime-verification","ssot","tdd"],"created_at":"2025-10-05T21:53:36.827Z","updated_at":"2025-10-05T21:53:38.129Z","avatar_url":"https://github.com/itdojp.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ae-framework: AI-Agent Enabled Framework\n\n[![validate-artifacts-ajv](https://github.com/itdojp/ae-framework/actions/workflows/validate-artifacts-ajv.yml/badge.svg)](https://github.com/itdojp/ae-framework/actions/workflows/validate-artifacts-ajv.yml)\n[![testing-ddd-scripts](https://github.com/itdojp/ae-framework/actions/workflows/testing-ddd-scripts.yml/badge.svg)](https://github.com/itdojp/ae-framework/actions/workflows/testing-ddd-scripts.yml)\n[![coverage-check](https://github.com/itdojp/ae-framework/actions/workflows/coverage-check.yml/badge.svg)](https://github.com/itdojp/ae-framework/actions/workflows/coverage-check.yml)\n[![pr-summary-comment](https://github.com/itdojp/ae-framework/actions/workflows/pr-summary-comment.yml/badge.svg)](https://github.com/itdojp/ae-framework/actions/workflows/pr-summary-comment.yml)\n\n\u003e **🌍 Language / 言語**: [English](#english) | [日本語](#japanese) | [Documentation / ドキュメント](#documentation-ドキュメント)\n\n---\n\n## English\n\nNote: Top-level documentation has been consolidated under `docs/` to keep the repository root tidy.\n\n**AI-Agent Enabled Framework for Test-Driven Development with 6-Phase Automation**\n\n\u003e Minimal human intervention, maximum specification compliance. Intent → Formal → Tests → Code → Verify → Operate with TDD enforcement.\n\n### 🚀 Key Features\n\n- **Complete Claude Code Integration**: All 6 phases automated through Task Tool adapters\n- **TDD Enforcement**: Automatic Test-Driven Development compliance\n- **OpenTelemetry Monitoring**: Real-time quality and performance metrics\n- **Phase 6 UI Generation**: React + Next.js components in \u003c30 seconds\n- **Bilingual Support**: Japanese/English documentation and UI\n\n### 🤖 Claude Code Task Tool Integration (All Phases)\n\n#### Full Automation\nae-framework provides **complete 6-phase automation** in Claude Code environment without additional configuration:\n\n**Phase 1: Intent Analysis** 🎯\n```\nUser: Please analyze the project requirements\n\nClaude Code: Executing Intent Task Adapter for requirement analysis...\n\n✅ Intent Analysis Complete - 12 requirements identified\n📋 Next steps:\n  • Proceed to Phase 2 (Natural Language Requirements)\n```\n\n**Phase 6: UI/UX \u0026 Frontend Delivery** 🎨\n```\nUser: Generate UI components\n\nClaude Code: Executing UI Task Adapter for component generation...\n\n📊 OpenTelemetry initialized for ae-framework Phase 6\n✅ Generated 21 files for 3/3 entities\n📊 Test Coverage: 100% (threshold: 80%)\n♿ A11y Score: 96% (threshold: 95%) ✅  \n⚡ Performance Score: 78% (threshold: 75%) ✅\n```\n\n### 🎯 6-Phase Workflow\n\n1. **Intent Analysis**: Extract requirements from natural language\n2. **Natural Language Requirements**: Structure and validate requirements\n3. **User Stories Creation**: Generate user stories and acceptance criteria\n4. **Validation**: Cross-validate requirements, stories, and specifications\n5. **Domain Modeling**: Create domain-driven design models\n6. **UI/UX \u0026 Frontend Delivery**: Generate React components with testing\n\n### 📦 Quick Start\n\n```bash\n# Install framework\nnpm install ae-framework\n\n# Initialize project with TDD\nae-framework init my-project --tdd\n\n# Generate complete feature\nae-framework feature \"User Authentication\"\nae-framework generate:tests  # RED phase\nae-framework generate:code   # GREEN phase\nae-framework verify         # Quality verification\nae-framework ui-scaffold --components  # UI generation\n```\n\n### 🎨 Phase 6: UI/UX Features\n\n- **React + Next.js**: Modern component generation\n- **Design System**: Radix UI + Tailwind CSS + Design Tokens\n- **Accessibility**: WCAG 2.1 AA compliance (96% score)\n- **Testing**: Playwright E2E + Storybook + Vitest\n- **i18n**: Multi-language support (ja/en)\n- **OpenTelemetry**: Real-time quality monitoring\n\n### 📊 Quality Gates \u0026 Metrics\n\n- ✅ Test Coverage: ≥80%\n- ✅ A11y Score: ≥95% (WCAG 2.1 AA)\n- ✅ Performance Score: ≥75% (Lighthouse CI)\n- ✅ TypeScript: Zero type errors, strict mode\n- ✅ ESLint: Zero syntax errors\n\nType Coverage Policy\n- Baseline: 65% is measured and commented on PRs.\n- Label-gated enforcement: Add PR label `enforce-typecov` to enforce 70% (CI fails if below).\n- Details: see `docs/quality/type-coverage-policy.md`.\n\nError Handling Policy (CLI)\n- Unknown-first error handling across CLI: `catch (error: unknown)` + `toMessage(error)` for safe formatting\n- Unified error prefix: `❌ \u003cshort prefix\u003e: \u003cmessage\u003e` with chalk.red\n- Static import for `error-utils` to improve type-safety and bundling\n\n### 🤝 Contributing\n\nWe welcome international contributions! Please see our [Contributing Guide](CONTRIBUTING.md).\n\n### 📚 Documentation\n\n- [Quick Start Guide](docs/getting-started/QUICK-START-GUIDE.md)\n- [Claude Code Integration](docs/integrations/CLAUDE-CODE-TASK-TOOL-INTEGRATION.md)\n- [CodeX Integration](docs/integrations/CODEX-INTEGRATION.md)\n  - [CodeX Quick Start](docs/integrations/QUICK-START-CODEX.md)\n- [API Reference](docs/reference/API.md)\n- [CLI Commands](docs/reference/CLI-COMMANDS-REFERENCE.md)\n\n### 🧪 CI Quick Guide\n\n- Minimal checks locally\n  - `pnpm run test:unit` / `pnpm run test:fast`\n  - Benchmark focused tests: see `docs/handoff/README.md`\n- Quality gates may fail depending on environment/policy\n  - Use `ae-framework quality run --env development --dry-run` for smoke\n  - Type coverage policy is reported at 65% baseline; `enforce-typecov` label enforces 70%\n  - Some jobs (security/audit/container) require network/secrets and may be red on forks\n\n---\n\n## Japanese\n\n注記: ルート直下のドキュメントを `docs/` 配下に整理し、トップ階層をスリム化しました。\n\n**TDD強制機能付き6フェーズ自動化のAIエージェント対応フレームワーク**\n\n\u003e 人手最小＆仕様準拠最大。Intent→Formal→Tests→Code→Verify→Operate の6フェーズ。\n\n### 📢 最新アップデート\n- **🆕 [🧪 Phase 2.3: Integration Testing System](./docs/phases/PHASE-2-3-INTEGRATION-TESTING.md)** - 包括的統合テストとE2Eテストオーケストレーション\n- **🆕 [🛡️ Phase 2.2: Runtime Conformance System](./docs/phases/PHASE-2-2-RUNTIME-CONFORMANCE.md)** - リアルタイム適合性検証とCEGIS連携\n- **[🔧 Phase 2.1: CEGIS Auto-Fix System](./docs/architecture/CEGIS-DESIGN.md)** - 反例誘導帰納合成による自動コード修復\n- **[🎨 Phase 6 UI/UX \u0026 Frontend Delivery完全実装](./docs/phases/phase-6-uiux.md)** - React + Next.js UI自動生成とOpenTelemetryテレメトリ\n- **[🚀 Phase 2-5 Claude Code Task Tool統合](./docs/integrations/CLAUDE-CODE-TASK-TOOL-INTEGRATION.md)** - 全フェーズの完全自動化を実現\n\n### 🔧 Claude Code Task Tool 統合（全フェーズ対応）\n\n#### 🚀 完全自動統合\nae-framework は Claude Code 環境で**全6フェーズ**を自動統合。追加設定なしで利用可能：\n\n**Phase 1: Intent Analysis 🎯**\n```\n\n### 📁 Repository Layout\n- Overview: `docs/README.md`\n- Project organization: `docs/project-organization.md`\n- Architecture notes: `docs/architecture/`\n- Quality and verification: `docs/quality/`\n- Benchmarks (req2run): `docs/benchmark/`\n- Articles: `docs/articles/` (e.g., Zenn)\n- CLI smoke example: `examples/cli-smoke/`\nUser: プロジェクトの要件分析をお願いします\n\nClaude Code: Intent Task Adapterを使用して要件分析を実行します...\n\n✅ Intent Analysis Complete - 12 requirements identified\n📋 Next steps:\n  • Proceed to Phase 2 (Natural Language Requirements)\n```\n\n**Phase 6: UI/UX \u0026 Frontend Delivery 🎨**\n```\nUser: UI コンポーネントを生成してください\n\nClaude Code: UI Task Adapterでコンポーネント生成中...\n\n📊 OpenTelemetry initialized for ae-framework Phase 6\n✅ Generated 21 files for 3/3 entities\n📊 Test Coverage: 100% (threshold: 80%)\n♿ A11y Score: 96% (threshold: 95%) ✅  \n⚡ Performance Score: 78% (threshold: 75%) ✅\n```\n\n### CLI実行も全フェーズ対応\n```bash\n# Phase 1: Intent分析\nae-framework intent --analyze --sources=\"requirements.md\"\n\n# Phase 6: UI/UX \u0026 Frontend Delivery\nae-framework ui-scaffold --components\nae-framework ui-scaffold --state\nae-framework ui-scaffold --tokens\nae-framework ui-scaffold --a11y\n\n# ae-ui エイリアス（同等の動作）\nae-ui scaffold --components\nae-ui scaffold --state  \nae-ui scaffold --tokens\nae-ui scaffold --a11y\n```\n\n### 🎯 主要機能\n\n#### 🤖 AI-Powered Development Features\n\n**🤖 Test Generation Agent (NEW!)**\n自動的に包括的なテストを生成する AI エージェント：\n- **要件からテスト生成**: 自然言語の要件から完全なテストスイートを作成\n- **コードからテスト逆生成**: 既存コードを分析してテストを生成（リバースTDD）\n- **Property-Based Testing**: 数学的性質からプロパティテストを自動設計\n- **BDD シナリオ生成**: ユーザーストーリーから Gherkin シナリオを作成\n\n**🛡️ TDD Enforcement Features**\nTDD（Test-Driven Development）原則の遵守を自動的に強制：\n- **TDD Guard**: コードファイルに対応するテストファイルの存在を強制\n- **Test Execution Guard**: コミット前の全テスト通過を確認\n- **RED-GREEN Cycle Guard**: RED→GREEN→REFACTORサイクルの遵守をチェック\n- **Coverage Guard**: 最低カバレッジ（80%）の維持を監視\n\n### 🎨 Phase 6: UI/UX \u0026 Frontend Delivery\n\n#### 品質ゲート（概要）\n- 型カバレッジ: 基準65%（PRコメント報告）、ラベル `enforce-typecov` 付与時に70%を強制（未満でCI失敗）。\n- 詳細は `docs/quality/type-coverage-policy.md` を参照してください。\n\nエラーハンドリング方針（CLI）\n- 全CLIで unknown-first: `catch (error: unknown)` + `toMessage(error)` による安全な整形\n- エラー出力の統一: `❌ \u003c短い前置き\u003e: \u003c本文\u003e`（chalk.red）\n- `error-utils` は静的 import 化（型安全性とバンドル最適化）\n\n### 🧪 CI クイックガイド\n\n- ローカルでの最小確認\n  - `pnpm run test:unit` / `pnpm run test:fast`\n  - ベンチマーク系の重点テストは `docs/handoff/README.md` を参照\n- Quality Gates は環境/ポリシーによりREDになる場合があります\n  - `ae-framework quality run --env development --dry-run` でスモーク\n  - 型カバレッジは65%基準のレポート、`enforce-typecov` ラベルで70%強制\n  - セキュリティ/監査/コンテナ系はネットワーク・シークレット前提のためフォーク環境ではREDになり得ます\n\n**OpenTelemetryテレメトリ監視**\nPhase 6では**OpenTelemetry**を使用してリアルタイム品質監視を実行：\n\n**監視メトリクス:**\n- **品質メトリクス**: テストカバレッジ(≥80%)、A11yスコア(≥95%)、パフォーマンススコア(≥75%)\n- **効率性メトリクス**: スキャフォールド時間(\u003c30秒)、E2Eテスト時間(\u003c5分)、ビルド時間\n- **保守性メトリクス**: コンポーネント複雑度(\u003c10)、未使用CSS率(\u003c5%)、デザイントークン使用率(≥95%)\n\n**生成されるファイル構成**\n```\n\n### 📁 リポジトリ構成\n- 概要: `docs/README.md`\n- プロジェクト構成: `docs/project-organization.md`\n- アーキテクチャ: `docs/architecture/`\n- 品質と検証: `docs/quality/`\n- ベンチマーク（req2run）: `docs/benchmark/`\n- 記事: `docs/articles/`（Zenn など）\n- CLI スモーク例: `examples/cli-smoke/`\nae-framework/\n├── packages/\n│   ├── design-tokens/                       # デザイントークン\n│   └── ui/                                  # UIコンポーネントライブラリ\n├── apps/\n│   ├── web/                                 # Next.js Webアプリケーション\n│   │   ├── app/{entity}/page.tsx            # 一覧ページ\n│   │   ├── app/{entity}/[id]/page.tsx       # 詳細ページ\n│   │   ├── messages/ja.json                 # 日本語翻訳\n│   │   ├── messages/en.json                 # 英語翻訳\n│   │   └── __e2e__/{entity}.spec.ts         # E2Eテスト\n│   └── storybook/                           # Storybookドキュメント\n└── templates/ui/                            # Handlebarsテンプレート\n```\n\n**技術仕様:**\n- **Framework**: Next.js 14 App Router\n- **UI Library**: Radix UI + Tailwind CSS + shadcn/ui  \n- **Design System**: Design Tokens + Class Variance Authority (CVA)\n- **Forms**: React Hook Form + Zod validation\n- **State**: TanStack Query 5 for server state\n- **Testing**: Playwright E2E + Storybook + Vitest\n- **i18n**: next-intl 多言語対応 (ja/en)\n- **A11y**: WCAG 2.1 AA準拠 + eslint-plugin-jsx-a11y\n- **Telemetry**: OpenTelemetry for quality metrics\n\n### 📦 Installation\n\n```bash\n# Node.js 20+ required\n# (optional) Enable Corepack to use bundled pnpm\n# corepack enable\npnpm install\n\n# Install Git hooks for TDD enforcement\npnpm run setup-hooks\n\n# Build the framework\npnpm run build\n```\n\n### 🚀 Quick Start\n\n```bash\n# 1. Initialize a new project with TDD enforcement\nae-framework init my-project --tdd\n\n# 2. Create a feature specification\nae-framework feature \"User Authentication\"\n\n# 3. Generate tests (Phase 3 - RED)\nae-framework generate:tests\n\n# 4. Generate implementation (Phase 4 - GREEN)\nae-framework generate:code\n\n# 5. Verify quality (Phase 5)\nae-framework verify\n\n# 6. Generate UI Components (Phase 6)\nae-framework ui-scaffold --components\n# または\nae-ui scaffold --components\n\n# 7. Deploy (Phase 6)\nae-framework deploy\n```\n\n---\n\n## 🔒 TypeScript Policy / TypeScript ポリシー\n\n### @ts-expect-error Usage Policy\n\nWhen using `@ts-expect-error` comments, follow this structured format:\n\n```typescript\n// @ts-expect-error owner:@username expires:YYYY-MM-DD reason: detailed description\n```\n\n**Required fields:**\n- `owner:@username` - GitHub handle responsible for the suppression\n- `expires:YYYY-MM-DD` - Date when this suppression should be reviewed/removed\n- `reason: description` - Detailed explanation (minimum 12 characters)\n\n**Examples:**\n```typescript\n// @ts-expect-error owner:@alice expires:2025-12-31 reason: narrowing todo for complex union\nconst result = complexUnion as string;\n\n// @ts-expect-error owner:@bob expires:2025-06-15 reason: legacy API compatibility until v2 migration\nlegacyApi.unsafeMethod(data);\n```\n\n**Policy enforcement:**\n- ✅ CI validates all `@ts-expect-error` comments\n- ⚠️ Local development shows warnings only\n- 🔍 Script: `node scripts/ci/check-expect-error.mjs`\n\n---\n\n## Documentation / ドキュメント\n\n### 🚀 Getting Started / 導入・クイックスタート\n- **[🚀 Quick Start Guide](docs/getting-started/QUICK-START-GUIDE.md)** - 15分で始めるae-framework / 15-minute ae-framework introduction\n- **[🎨 Phase 6 Getting Started](docs/getting-started/PHASE-6-GETTING-STARTED.md)** - UI/UX専用クイックスタート / UI/UX focused quick start\n- [Setup Guide](docs/getting-started/SETUP.md) - 基本セットアップ / Basic setup\n\n### 📝 Practical Guides / 実用ガイド\n- **[🎯 Development Instructions Guide](docs/guides/DEVELOPMENT-INSTRUCTIONS-GUIDE.md)** - 実際の開発指示方法 / Practical development instruction methods\n- **[🚀 Claude Code Automation Guide](docs/guides/CLAUDE-CODE-AUTOMATION-GUIDE.md)** - 要求から実装まで完全自動化 / Complete automation from requirements to implementation\n- [Usage Guide](docs/guides/USAGE.md) - 一般的な使い方ガイド / General usage guide\n\n### 🎯 Phase-by-Phase Details / フェーズ別詳細\n- [Phase 2: Natural Language Requirements](docs/phases/PHASE-2-NATURAL-LANGUAGE-REQUIREMENTS.md) - 自然言語要件処理 / Natural language requirement processing\n- **🆕 [Phase 2.1: CEGIS Auto-Fix System](docs/architecture/CEGIS-DESIGN.md)** - 反例誘導帰納合成による自動コード修復 / Counterexample-guided inductive synthesis for automatic code repair\n- **🆕 [Phase 2.2: Runtime Conformance System](docs/phases/PHASE-2-2-RUNTIME-CONFORMANCE.md)** - リアルタイム適合性検証とCEGIS連携 / Real-time conformance verification and CEGIS integration\n- **🆕 [Phase 2.3: Integration Testing System](docs/phases/PHASE-2-3-INTEGRATION-TESTING.md)** - 包括的統合テストとE2Eテストオーケストレーション / Comprehensive integration and E2E test orchestration\n- **[Phase 6: UI/UX \u0026 Frontend Delivery](docs/phases/phase-6-uiux.md)** - React + Next.js UI自動生成 / React + Next.js UI automatic generation\n\n### 🔗 Integration \u0026 Workflow / 統合・ワークフロー\n- **[Claude Code Task Tool Integration](docs/integrations/CLAUDE-CODE-TASK-TOOL-INTEGRATION.md)** - 全フェーズ統合詳細 / Complete phase integration details\n- [Claude Code Workflow](docs/integrations/CLAUDECODE-WORKFLOW.md) - Claude Codeワークフロー / Claude Code workflow\n\n### 📚 Reference / リファレンス\n- **[CLI Commands Reference](docs/reference/CLI-COMMANDS-REFERENCE.md)** - 全コマンドリファレンス / Complete command reference\n- [API Reference](docs/reference/API.md) - API仕様 / API specifications\n\n### 🏗️ Architecture \u0026 Design / アーキテクチャ・設計\n- **[TDD Framework Architecture](docs/architecture/TDD-FRAMEWORK-ARCHITECTURE.md)** - TDDフレームワーク設計 / TDD framework design\n- [System Architecture](docs/architecture/ARCHITECTURE.md) - システムアーキテクチャ / System architecture\n\n### 📚 Complete Navigation / 全体ナビゲーション\n**[docs/README.md](docs/README.md)** - 全ドキュメントの体系的ナビゲーションガイド / Systematic documentation navigation guide\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n貢献を歓迎します！詳細は[コントリビューションガイド](CONTRIBUTING.md)をご覧ください。\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\nBuilt with:\n- MCP SDK for agent communication\n- OpenAI/Anthropic APIs for AI capabilities\n- Next.js 14 + React 18 for UI generation\n- Radix UI + Tailwind CSS for design system\n- OpenTelemetry for telemetry and monitoring\n- Vitest for testing framework\n\n### CI Gate\n- PR: `PR Verify` workflow runs `ae verify`, replay smoke, uploads artifacts (14d retention).\n- Nightly: `nightly-monitoring` runs flake(×30) and compares two seeded benches (≤5%) at JST 04:15.\n- Replay policy: PR=**replay** by default, main/nightly may record separately if needed.\n- Required check: set **PR Verify / verify** as a required status in branch protection (use `./scripts/setup-branch-protection.sh`).\n- Slack alerts: verify/nightly failures notify Slack (requires `SLACK_WEBHOOK_URL` secret).\n\n#### Verification Environment Controls\n- `AE_TYPES_STRICT=1`: CI strict mode (failures exit 1), `0` for local soft mode (warnings only)\n- `AE_LINT_SCOPE`: ESLint scope pattern (default: `\"src/{providers,commands}/**/*.ts\"`)\n- `AE_TSC_PROJECT`: TypeScript project config (default: `\"tsconfig.verify.json\"`)\n- `AE_EXPECT_ERROR_STRICT=1`: Enable @ts-expect-error policy enforcement (default: enabled)\n\n#### Benchmark Policy\n- Default tolerance: 5% for performance regression detection\n- Environment override: Set `BENCH_TOLERANCE` to customize (takes priority over command arguments)\n- Nightly monitoring: Automated bench comparison with seeded runs for consistency\n\n#### Flake Detection Policy\n- Default: 5-10 runs for standard flake detection\n- Opt-in extended testing: Add `run-flake` label to PR for 20-30 runs (statistical analysis)\n- Extended flake tests use `continue-on-error: true` to avoid blocking PR merges\n\n#### Cassette Policy\n- **Generated cassettes** (`artifacts/cassettes/`): Never commit (build artifacts, ignore in git)\n- **Fixed cassettes** (if needed): Use `cassettes/fixtures/` with mandatory code review\n- **PR policy**: New cassettes OK, existing cassette changes require review\n- **Alternative storage**: Consider separate repo or Git LFS for large cassette collections\n\n#### Slack Alerts Setup\n1. Go to repository **Settings** → **Secrets and variables** → **Actions**\n2. Click **New repository secret**\n3. Name: `SLACK_WEBHOOK_URL`, Value: your Slack webhook URL\n4. Save - failures will now trigger Slack notifications\n5. If secret is not set, notification step is automatically skipped\n\n---\n\n**ae-framework** - Automating excellence through AI-driven development 🚀\n\n\u003c!-- PR#269 merge verification --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitdojp%2Fae-framework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitdojp%2Fae-framework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitdojp%2Fae-framework/lists"}