{"id":43229294,"url":"https://github.com/popup-studio-ai/bkit-gemini","last_synced_at":"2026-04-06T09:02:38.535Z","repository":{"id":335777955,"uuid":"1146824518","full_name":"popup-studio-ai/bkit-gemini","owner":"popup-studio-ai","description":"bkit Vibecoding Kit for Gemini CLI - PDCA + AI-native development","archived":false,"fork":false,"pushed_at":"2026-03-20T17:32:40.000Z","size":3164,"stargazers_count":41,"open_issues_count":0,"forks_count":10,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-03-20T23:17:26.221Z","etag":null,"topics":["ai-agents","ai-driven-work","ai-native-development","bkit","extensions","gemini","multi-language","pdca","pipeline"],"latest_commit_sha":null,"homepage":"https://bkit.ai","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/popup-studio-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-31T18:33:33.000Z","updated_at":"2026-03-20T15:58:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/popup-studio-ai/bkit-gemini","commit_stats":null,"previous_names":["popup-studio-ai/bkit-gemini"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/popup-studio-ai/bkit-gemini","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/popup-studio-ai%2Fbkit-gemini","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/popup-studio-ai%2Fbkit-gemini/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/popup-studio-ai%2Fbkit-gemini/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/popup-studio-ai%2Fbkit-gemini/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/popup-studio-ai","download_url":"https://codeload.github.com/popup-studio-ai/bkit-gemini/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/popup-studio-ai%2Fbkit-gemini/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31466228,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-06T08:36:52.050Z","status":"ssl_error","status_checked_at":"2026-04-06T08:36:51.267Z","response_time":112,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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-agents","ai-driven-work","ai-native-development","bkit","extensions","gemini","multi-language","pdca","pipeline"],"created_at":"2026-02-01T10:02:23.379Z","updated_at":"2026-04-06T09:02:38.527Z","avatar_url":"https://github.com/popup-studio-ai.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bkit - Vibecoding Kit (Gemini CLI Edition)\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-v0.34.0+-blue.svg)](https://github.com/google-gemini/gemini-cli)\n[![Version](https://img.shields.io/badge/Version-2.0.3-green.svg)](CHANGELOG.md)\n[![Author](https://img.shields.io/badge/Author-POPUP%20STUDIO-orange.svg)](https://popupstudio.ai)\n\n\u003e **PDCA methodology + Context Engineering for AI-native development**\n\nbkit is a [Gemini CLI](https://github.com/google-gemini/gemini-cli) extension that transforms how you build software with AI. It provides structured development workflows, automatic documentation, and intelligent code assistance through the PDCA (Plan-Do-Check-Act) methodology and Context Engineering architecture.\n\n![Smart Onboarding](images/bkit-smart-onboarding.png)\n*Smart onboarding detects your project level and guides you through setup*\n\n---\n\n## What is Context Engineering?\n\n**Context Engineering** is the systematic curation of context tokens for optimal LLM inference -- going beyond simple prompt crafting to build entire systems that consistently guide AI behavior.\n\n```\nTraditional Prompt Engineering:\n  \"The art of writing good prompts\"\n\nContext Engineering:\n  \"The art of designing systems that integrate prompts, tools, and state\n   to provide LLMs with optimal context for inference\"\n```\n\n**bkit is a practical implementation of Context Engineering**, providing a systematic context management system for Gemini CLI through three interconnected layers.\n\n---\n\n## Architecture\n\n### Context Engineering Layers\n\n| Layer | Components | Count | Purpose |\n|-------|-----------|-------|---------|\n| **Domain Knowledge** | Skills | 35 | Structured expert knowledge activated on-demand via progressive disclosure |\n| **Behavioral Rules** | Agents | 21 | Role-based constraints with model, tools, temperature configuration |\n| **State Management** | Hook Scripts + Lib Modules | 17 + 13 | PDCA status tracking, intent detection, permission control, memory persistence, team orchestration |\n\n### 10-Event Hook System\n\nbkit intercepts Gemini CLI's full lifecycle through 10 hook events, enabling comprehensive automation without modifying the CLI source:\n\n```\nEvent 1:  SessionStart         -\u003e Initialize session, detect project level, load output style\nEvent 2:  BeforeAgent          -\u003e Intent detection, 8-language trigger matching, ambiguity scoring\nEvent 3:  BeforeModel          -\u003e PDCA phase-specific prompt augmentation\nEvent 4:  AfterModel           -\u003e Response tracking, usage metrics\nEvent 5:  BeforeToolSelection  -\u003e Phase-based tool filtering (plan -\u003e readOnly, do -\u003e all)\nEvent 6:  BeforeTool           -\u003e Permission manager, dangerous command blocking (exit code 2)\nEvent 7:  AfterTool            -\u003e PDCA phase auto-transition (design -\u003e do on source write)\nEvent 8:  AfterAgent           -\u003e Cleanup, phase completion detection\nEvent 9:  PreCompress          -\u003e Context fork snapshot preservation before compression\nEvent 10: SessionEnd           -\u003e Session cleanup, memory persistence\n```\n\n### Extension Component Map\n\n```\nbkit-gemini/\n|-- gemini-extension.json         # Extension manifest (v2.0.0)\n|-- GEMINI.md                     # Global context with 7 @import modules\n|-- bkit.config.json              # Centralized configuration (12 sections)\n|-- CHANGELOG.md                  # Version history\n|\n|-- .gemini/context/              # @import context modules\n|   |-- pdca-rules.md             # PDCA enforcement rules\n|   |-- commands.md               # Command reference\n|   |-- agent-triggers.md         # Agent activation triggers\n|   |-- skill-triggers.md         # Skill activation triggers\n|   |-- tool-reference-v2.md      # Tool name reference (Gemini CLI native)\n|   |-- feature-report.md         # Feature usage report format\n|   +-- executive-summary-rules.md # Executive summary output rules\n|\n|-- agents/                       # 21 specialized AI agents\n|   |-- cto-lead.md               # CTO-level orchestration\n|   |-- frontend-architect.md     # UI/UX architecture\n|   |-- security-architect.md     # Security \u0026 vulnerability analysis\n|   |-- product-manager.md        # Requirements \u0026 prioritization\n|   |-- qa-strategist.md          # Test strategy coordination\n|   |-- gap-detector.md           # Design-implementation gap analysis\n|   |-- pdca-iterator.md          # Evaluator-Optimizer iteration\n|   |-- code-analyzer.md          # Code quality analysis\n|   |-- report-generator.md       # PDCA completion reports\n|   |-- design-validator.md       # Design document validation\n|   |-- qa-monitor.md             # Docker log monitoring\n|   |-- starter-guide.md          # Beginner guidance\n|   |-- pipeline-guide.md         # Pipeline guidance\n|   |-- bkend-expert.md           # bkend.ai BaaS expertise\n|   |-- enterprise-expert.md      # Enterprise architecture\n|   |-- infra-architect.md        # AWS/K8s/Terraform\n|   |-- pm-lead.md                # PM Team Lead orchestration\n|   |-- pm-discovery.md           # Market/user opportunity discovery\n|   |-- pm-strategy.md            # Value proposition \u0026 Lean Canvas\n|   |-- pm-research.md            # Personas, competitors, market sizing\n|   +-- pm-prd.md                 # PRD synthesis \u0026 GTM strategy\n|\n|-- skills/                       # 35 domain skills (progressive disclosure)\n|   |-- pdca/SKILL.md             # Unified PDCA management (8 actions)\n|   |-- starter/SKILL.md          # Static web development\n|   |-- dynamic/SKILL.md          # Fullstack with BaaS\n|   |-- enterprise/SKILL.md       # Microservices architecture\n|   |-- development-pipeline/     # 9-phase pipeline\n|   |-- code-review/              # Code review\n|   |-- zero-script-qa/           # Log-based testing\n|   |-- mobile-app/               # React Native, Flutter, Expo\n|   |-- desktop-app/              # Electron, Tauri\n|   |-- bkit-templates/           # PDCA document templates\n|   |-- bkit-rules/               # Core rules\n|   |-- gemini-cli-learning/      # Gemini CLI mastery\n|   |-- phase-{1..9}-*/           # 9 pipeline phase skills\n|   |-- plan-plus/                # Brainstorming-enhanced planning\n|   |-- simplify/                 # Code quality review\n|   |-- batch/                    # Parallel multi-feature PDCA\n|   |-- loop/                     # Recurring interval execution\n|   |-- output-style-setup/       # Output style installation\n|   |-- pm-discovery/             # PM Agent Team workflow\n|   |-- bkend-quickstart/         # bkend.ai platform onboarding\n|   |-- bkend-auth/               # bkend.ai authentication\n|   |-- bkend-data/               # bkend.ai database CRUD\n|   |-- bkend-storage/            # bkend.ai file storage\n|   |-- bkend-mcp/                # bkend.ai MCP tools \u0026 AI integration\n|   |-- bkend-security/           # bkend.ai security policies\n|   |-- bkend-cookbook/            # bkend.ai project tutorials\n|   +-- bkend-guides/             # bkend.ai operational guides\n|\n|-- commands/                     # 24 TOML custom commands\n|   |-- bkit.toml                 # /bkit help\n|   |-- pdca.toml                 # /pdca (plan, design, do, analyze, iterate, report, status, next)\n|   |-- review.toml               # /review\n|   |-- qa.toml                   # /qa\n|   |-- starter.toml              # /starter\n|   |-- dynamic.toml              # /dynamic\n|   |-- enterprise.toml           # /enterprise\n|   |-- pipeline.toml             # /pipeline\n|   |-- learn.toml                # /learn\n|   |-- github-stats.toml         # /github-stats\n|   |-- plan-plus.toml            # /plan-plus\n|   |-- simplify.toml             # /simplify\n|   |-- batch.toml                # /batch\n|   |-- loop.toml                 # /loop\n|   |-- output-style-setup.toml   # /output-style-setup\n|   |-- pm-discovery.toml         # /pm-discovery\n|   |-- bkend-quickstart.toml     # /bkend-quickstart\n|   |-- bkend-auth.toml           # /bkend-auth\n|   |-- bkend-data.toml           # /bkend-data\n|   |-- bkend-storage.toml        # /bkend-storage\n|   |-- bkend-mcp.toml            # /bkend-mcp\n|   |-- bkend-security.toml       # /bkend-security\n|   |-- bkend-cookbook.toml        # /bkend-cookbook\n|   +-- bkend-guides.toml         # /bkend-guides\n|\n|-- hooks/\n|   |-- hooks.json                # 10 hook event registrations\n|   +-- scripts/                  # 17 hook scripts\n|       |-- session-start.js      # Dynamic context injection (392 lines)\n|       |-- before-agent.js       # Intent detection (186 lines)\n|       |-- before-model.js       # Prompt augmentation (131 lines)\n|       |-- after-model.js        # Response tracking\n|       |-- before-tool-selection.js  # Tool filtering (158 lines)\n|       |-- before-tool.js        # Permission + PDCA (188 lines)\n|       |-- after-tool.js         # Phase transition (142 lines)\n|       |-- after-agent.js        # Cleanup\n|       |-- pre-compress.js       # Context preservation\n|       |-- session-end.js        # Session cleanup\n|       |-- skills/               # 5 per-skill post-processor hooks\n|       +-- utils/                # 2 utility modules\n|\n|-- output-styles/                # 4 output styles\n|   |-- bkit-learning.md          # Beginner-friendly explanations\n|   |-- bkit-pdca-guide.md        # PDCA workflow guidance\n|   |-- bkit-enterprise.md        # Enterprise-level technical\n|   +-- bkit-pdca-enterprise.md   # Enterprise PDCA combined\n|\n|-- lib/\n|   |-- skill-orchestrator.js     # Custom YAML parser, agent delegation, Skills 2.0 classification\n|   |-- context-hierarchy.js      # 4-level config merge (209 lines)\n|   |-- core/\n|   |   |-- paths.js              # Centralized path registry (v2.0.0)\n|   |   |-- agent-memory.js       # Per-agent persistence (214 lines)\n|   |   +-- permission.js         # Glob pattern permission engine (381 lines)\n|   |-- team/                     # Team orchestration (v2.0.0, 9 modules)\n|   |   |-- coordinator.js        # Task coordination\n|   |   |-- cto-logic.js          # CTO-level orchestration (5 patterns)\n|   |   |-- communication.js      # MCP/memory protocols\n|   |   |-- memory.js             # Team memory persistence\n|   |   |-- pattern-selector.js   # Orchestration pattern selection\n|   |   |-- state-recorder.js     # State snapshots\n|   |   |-- strategy.js           # Strategy enum (dynamic/enterprise/custom)\n|   |   +-- task-queue.js         # Task queueing\n|   |-- intent/\n|   |   +-- language-patterns.js  # 8-language intent detection patterns\n|   +-- adapters/gemini/\n|       |-- index.js              # Platform adapter with TOOL_MAP\n|       |-- tool-registry.js      # Tool name registry + Annotations (v0.29.0~v0.33.x, 23 tools)\n|       |-- version-detector.js   # 3-strategy CLI version detection + 34 feature flags\n|       |-- policy-migrator.js    # Permission -\u003e TOML Policy + Extension/Level Policy (v0.30.0+)\n|       |-- hook-adapter.js       # RuntimeHook SDK integration (v0.31.0+)\n|       |-- tracker-bridge.js     # Task Tracker - PDCA Bridge (v0.32.0+)\n|       |-- context-fork.js       # Snapshot isolation, LRU(10) (477 lines)\n|       +-- import-resolver.js    # @import resolution (118 lines)\n|\n+-- mcp/\n    +-- spawn-agent-server.js     # 6 MCP tools (753 lines)\n```\n\n---\n\n## Features\n\n### v2.0.0 Highlights\n\n- **Gemini CLI Native Architecture** -- Complete removal of Claude Code legacy; standalone Gemini CLI extension with zero external dependencies\n- **Phase-Aware Context** -- `PHASE_CONTEXT_MAP` loads only relevant context files per PDCA phase (plan/design/do/check/act/idle), reducing idle session tokens by ~60%\n- **3-Tier Agent Security Model** -- `readonly` (8 agents, read-only), `docwrite` (6 agents, file creation), `full` (3 agents, implementation/orchestration) with TOML Policy Engine enforcement\n- **19 Feature Flags** -- Version-gated capabilities for Gemini CLI v0.30.0~v0.34.0+ (Policy Engine, Project-Level Policy, Extension Policies, Task Tracker, RuntimeHook)\n- **Skill Visibility Control** -- Level-based skill filtering (Starter: 5 skills, Dynamic: 22 skills, Enterprise: all)\n- **Flat Module Architecture** -- `lib/gemini/` replaces adapter pattern; direct imports with no bridge modules\n- **115 v2.0.0 Test Cases** -- Sprint 5 (103 TCs) + Sprint 6 (12 TCs) covering architecture migration, security tiers, and policy engine\n- **Minimum CLI Version: v0.34.0** -- Leverages native skill system, ACP, extension validation, and subagent policies\n\n### v1.5.8 Highlights\n\n- **PM Agent Team** -- 5 new agents (pm-lead, pm-discovery, pm-strategy, pm-research, pm-prd) for comprehensive product discovery before PDCA Plan phase\n- **Team Orchestration** -- 9 modules with 5 patterns (Leader, Council, Swarm, Pipeline, Watchdog) for coordinated multi-agent workflows\n- **6 New Skills** -- plan-plus (brainstorming-enhanced planning), simplify (code quality review), batch (parallel PDCA), loop (recurring execution), output-style-setup, pm-discovery\n- **6 New Commands** -- `/plan-plus`, `/simplify`, `/batch`, `/loop`, `/output-style-setup`, `/pm-discovery`\n- **Skills 2.0 Classification** -- 35 skills categorized as Workflow (9), Capability (25), or Hybrid (1)\n- **Path Registry** -- Centralized state file management in `lib/core/paths.js` with auto-migration from legacy paths\n- **972 Test Cases** -- 78 test suites covering 11 perspectives (unit, E2E, integration, scenario, philosophy, security, edge cases, recovery)\n- **Gemini CLI v0.33.x Compatibility** -- Tested through v0.33.0-preview.4\n\n### v1.5.7 Highlights\n\n- **Gemini CLI v0.32.x Compatibility** -- 11 new feature flags for Task Tracker, Extension Policies, Model Family Toolsets, A2A Streaming, and more\n- **23 Built-in Tools** -- 6 new Task Tracker tools registered (tracker_create_task, tracker_update_task, tracker_get_task, tracker_list_tasks, tracker_add_dependency, tracker_visualize)\n- **SDK RuntimeHook Dual-Mode** -- 6 hot-path hooks converted to SDK function export + stdin command fallback for 40-97% latency reduction\n- **Extension Policy Engine** -- Tier 2 TOML extension policy replacing deprecated excludeTools in gemini-extension.json\n- **Task Tracker - PDCA Bridge** -- Instruction-based bridge connecting PDCA workflow to native Task Tracker (v0.32.0+)\n- **Bug Guards** -- AfterAgent loop guard (Issue #20426) and sub-agent timeout cap (600s) with SIGTERM→SIGKILL escalation\n- **Nightly Version Parsing** -- parseVersion() now handles `0.34.0-nightly.20260304` format\n\n### v1.5.6 Highlights\n\n- **Gemini CLI v0.31.0 Compatibility** -- 9 new feature flags including RuntimeHook functions, Browser Agent, Tool Annotations, and Project-Level Policy\n- **Tool Annotations** -- readOnlyHint, destructiveHint, idempotentHint metadata for all 17 built-in tools enabling trust model and parallel execution optimization\n- **Level-Specific Policy Engine** -- Auto-generated Tier 3 TOML policies per project level (Starter: restrictive, Dynamic: balanced, Enterprise: permissive)\n- **Hook Adapter Module** -- RuntimeHook function detection and SDK migration preparation for v1.6.0\n- **Enhanced Version Detector** -- 17 feature flags organized by CLI version (v0.26.0+, v0.29.0+, v0.30.0+, v0.31.0+)\n\n### v1.5.5 Highlights\n\n- **Gemini 3 Model Migration** -- All 16 agents updated to `gemini-3-pro` (9) and `gemini-3-flash` (7)\n- **Version Detector** -- 3-strategy Gemini CLI version detection with feature flags and caching\n- **Policy Engine Migrator** -- Auto-converts bkit permissions to v0.30.0 TOML policy format\n- **Forward Alias Layer** -- Pre-mapped future tool name changes for seamless CLI upgrades\n- **v0.30.0 Forward Compatibility** -- Policy Engine support with auto-generate and fallback\n\n### v1.5.3 Highlights\n\n- **Gemini CLI v0.29.0+ Compatibility** -- All tool names verified from source code (Issue #5 fix)\n- **Tool Registry Module** -- Centralized tool name management for future-proof maintenance\n- **17 Built-in Tools Mapped** -- Including new Plan Mode tools (enter_plan_mode, exit_plan_mode)\n- **v0.30.0 Readiness** -- Policy Engine detection layer for smooth migration\n\n### v1.5.2 Highlights\n\n- **8 bkend.ai Domain Skills** -- quickstart, auth, data, storage, mcp, security, cookbook, guides\n- **8 bkend.ai Commands** -- TOML commands for each bkend domain skill\n- **bkend-expert Agent Rewrite** -- Complete rewrite with 28 MCP tools, bkendFetch pattern, 15 troubleshooting entries\n- **16 Specialized Agents** with Gemini native frontmatter (model, tools, temperature, max_turns, timeout_mins)\n- **29 Domain Skills** with progressive disclosure to save context tokens\n- **10-Event Hook System** covering the full Gemini CLI lifecycle\n- **PDCA Methodology** with automatic phase transitions and enforcement\n- **Context Engineering** with 3-layer architecture (Domain Knowledge, Behavioral Rules, State Management)\n- **8-Language Support** -- EN, KO, JA, ZH, ES, FR, DE, IT with auto-detection\n- **4 Output Styles** -- bkit-learning, bkit-pdca-guide, bkit-enterprise, bkit-pdca-enterprise\n- **Agent Memory** -- Per-agent persistent storage across sessions (project/user scope)\n- **Team Mode Foundation** -- 3 MCP tools for agent team coordination\n- **Skill Orchestrator** -- Custom YAML parser, agent delegation, template auto-loading\n- **Context Hierarchy** -- 4-level config merge (Plugin -\u003e User -\u003e Project -\u003e Session)\n- **Permission Manager** -- Glob pattern matching with PDCA phase restrictions\n- **9-Stage Development Pipeline** -- From schema design to deployment\n- **3 Project Levels** -- Starter (static), Dynamic (fullstack), Enterprise (microservices)\n- **@import Modularization** -- GEMINI.md split into 6 focused context modules\n- **Evaluator-Optimizer Pattern** -- Automatic iteration from Anthropic's agent architecture\n\n---\n\n## Quick Start\n\n\u003e **Note**: bkit-gemini is designed for **Gemini CLI**. For Claude Code, see [bkit-claude-code](https://github.com/popup-studio-ai/bkit-claude-code).\n\n### Prerequisites\n\n- [Gemini CLI](https://github.com/google-gemini/gemini-cli) v0.29.0 or later\n- [Git](https://git-scm.com/) installed on your machine\n\n### Installation\n\n#### Option 1: CLI Install (Recommended)\n\n```bash\ngemini extensions install https://github.com/popup-studio-ai/bkit-gemini.git\n```\n\n#### Option 2: Manual Install\n\n```bash\ngit clone https://github.com/popup-studio-ai/bkit-gemini.git ~/.gemini/extensions/bkit\n```\n\n### Verify Installation\n\n```bash\n# In interactive mode\n/extensions list\n\n# Or in non-interactive mode\ngemini extensions list\n\n# View bkit help\n/bkit\n```\n\n### Hooks Configuration\n\nHooks are **enabled by default** in Gemini CLI v0.29.0+. If you need to manually configure:\n\n```json\n// ~/.gemini/settings.json\n{\n  \"hooksConfig\": {\n    \"enabled\": true\n  }\n}\n```\n\n\u003e **Note:** Do NOT use `\"tools\": { \"enableHooks\": true }` -- this is incorrect syntax.\n\n### Extension Settings\n\nbkit provides user-configurable settings accessible via Gemini CLI's settings dialog:\n\n| Setting | Environment Variable | Description |\n|---------|---------------------|-------------|\n| Output Style | `BKIT_OUTPUT_STYLE` | Response formatting (bkit-learning, bkit-pdca-guide, bkit-enterprise, bkit-pdca-enterprise) |\n| Project Level | `BKIT_PROJECT_LEVEL` | Override auto-detected level (Starter, Dynamic, Enterprise) |\n\n---\n\n## Usage\n\n### /bkit Command Reference\n\nRun `/bkit` at any time to see all available commands and capabilities.\n\n### PDCA Workflow\n\n```bash\n/pdca plan \u003cfeature\u003e     # Create plan document\n/pdca design \u003cfeature\u003e   # Create design document\n/pdca do \u003cfeature\u003e       # Implementation guide\n/pdca analyze \u003cfeature\u003e  # Run gap analysis (delegates to gap-detector agent)\n/pdca iterate \u003cfeature\u003e  # Auto-improvement (delegates to pdca-iterator agent)\n/pdca report \u003cfeature\u003e   # Generate completion report (delegates to report-generator)\n/pdca status             # Check current PDCA status\n/pdca next               # Guide to next PDCA step\n```\n\n### Project Initialization\n\n```bash\n/starter init \u003cname\u003e     # Static website (Starter level)\n/dynamic init \u003cname\u003e     # Fullstack with BaaS (Dynamic level)\n/enterprise init \u003cname\u003e  # Microservices with K8s (Enterprise level)\n```\n\n### Development Pipeline\n\n```bash\n/pipeline start          # Start 9-phase pipeline\n/pipeline next           # Advance to next phase\n/pipeline status         # Show current phase\n```\n\n### Quality Management\n\n```bash\n/review \u003cpath\u003e           # Code review with code-analyzer agent\n/qa                      # Zero Script QA via Docker log monitoring\n```\n\n### Enhanced Planning\n\n```bash\n/plan-plus \u003cfeature\u003e     # Brainstorming-enhanced PDCA planning\n/pm-discovery \u003cfeature\u003e  # PM Agent Team product discovery and PRD\n```\n\n### Automation\n\n```bash\n/simplify                # Code quality review and simplification\n/batch \u003cfeatures\u003e        # Process multiple features in parallel\n/loop \u003cinterval\u003e \u003ccmd\u003e   # Run command on recurring interval (e.g., /loop 5m /pdca status)\n```\n\n### Output Styles\n\n```bash\n/output-style            # Change response formatting style\n/output-style-setup      # Install output style files\n```\n\n### Learning\n\n```bash\n/learn                   # Gemini CLI configuration learning\n/learn setup             # Analyze and optimize current project setup\n```\n\n---\n\n## User Experience\n\n### Smart Onboarding\n\nWhen you start a session, bkit automatically:\n1. **Detects project level** -- scans for `kubernetes/` (Enterprise), `docker-compose.yml` (Dynamic), or defaults to Starter\n2. **Loads appropriate output style** -- Starter gets beginner-friendly, Enterprise gets technical\n3. **Detects returning users** -- shows feature history and recent PDCA progress\n4. **Generates dynamic context** -- injects PDCA rules, agent triggers, and feature reports\n\n### 8-Language Auto-Detection\n\nbkit recognizes natural language triggers in 8 languages and automatically activates the appropriate agent or skill:\n\n| Language | Example Triggers |\n|----------|-----------------|\n| English | \"verify implementation\", \"analyze code\", \"create report\" |\n| Korean | \"검증해줘\", \"분석해줘\", \"보고서 작성\" |\n| Japanese | \"確認して\", \"分析して\", \"レポート作成\" |\n| Chinese | \"验证\", \"分析代码\", \"生成报告\" |\n| Spanish | \"verificar\", \"analizar\", \"crear informe\" |\n| French | \"verifier\", \"analyser\", \"creer rapport\" |\n| German | \"prufen\", \"analysieren\", \"Bericht erstellen\" |\n| Italian | \"verificare\", \"analizzare\", \"creare rapporto\" |\n\n### Agent Memory Persistence\n\nAll 21 agents remember context across sessions automatically:\n- **Project scope** (default): Memory stored in `.gemini/agent-memory/bkit/` -- shared across team\n- **User scope** (starter-guide, pipeline-guide): Memory stored in `~/.gemini/agent-memory/bkit/` -- personal\n- Maximum 20 sessions retained per agent\n\n### Output Styles\n\n| Style | Best For | Description |\n|-------|----------|-------------|\n| `bkit-learning` | Beginners | Step-by-step explanations with context |\n| `bkit-pdca-guide` | Standard development | PDCA workflow guidance with document templates |\n| `bkit-enterprise` | Enterprise teams | Technical architecture focus |\n| `bkit-pdca-enterprise` | Enterprise PDCA | Combined enterprise and PDCA methodologies |\n\n### Team Orchestration\n\nbkit v1.5.8 includes full team orchestration with 5 coordination patterns:\n\n| Pattern | Description | Use Case |\n|---------|-------------|----------|\n| **Leader** | 1 lead + N workers | Standard feature development |\n| **Council** | Equal peers | Architecture decisions |\n| **Swarm** | Dynamic pool | High-parallelism tasks |\n| **Pipeline** | Sequential chain | Multi-phase workflows |\n| **Watchdog** | Monitor + actors | Continuous monitoring |\n\n9 dedicated modules in `lib/team/` handle coordination, communication, state recording, and memory persistence. MCP tools: `team_create`, `team_assign`, `team_status`.\n\n---\n\n## Project Levels\n\n| Level | Description | Stack | Auto-Detection |\n|-------|-------------|-------|----------------|\n| **Starter** | Static websites, portfolios | HTML, CSS, JS | Default (no special files) |\n| **Dynamic** | Fullstack applications | Next.js, BaaS | `docker-compose.yml`, `.mcp.json` |\n| **Enterprise** | Microservices architecture | K8s, Terraform, MSA | `kubernetes/`, `terraform/` directories |\n\n---\n\n## Agents (21)\n\n| Agent | Category | Description |\n|-------|----------|-------------|\n| **cto-lead** | Leadership | CTO-level orchestration, PDCA workflow management |\n| **frontend-architect** | Architecture | UI/UX design, component structure, Design System |\n| **security-architect** | Architecture | Vulnerability analysis, OWASP Top 10 compliance |\n| **product-manager** | Management | Requirements analysis, feature prioritization, user stories |\n| **qa-strategist** | Quality | Test strategy, quality metrics, verification coordination |\n| **gap-detector** | PDCA Check | Design-implementation gap analysis |\n| **pdca-iterator** | PDCA Act | Evaluator-Optimizer pattern, auto-fix iteration |\n| **code-analyzer** | Quality | Code quality, security scan, architecture compliance |\n| **report-generator** | PDCA Act | PDCA completion report generation |\n| **design-validator** | PDCA Design | Design document completeness validation |\n| **qa-monitor** | Quality | Docker log monitoring, Zero Script QA execution |\n| **starter-guide** | Onboarding | Beginner-friendly step-by-step guidance |\n| **pipeline-guide** | Pipeline | 9-phase development pipeline navigation |\n| **bkend-expert** | Backend | bkend.ai BaaS platform expertise |\n| **enterprise-expert** | Architecture | Enterprise-grade system strategy, microservices |\n| **infra-architect** | Infrastructure | AWS, Kubernetes, Terraform infrastructure design |\n| **pm-lead** | PM Team | PM team orchestration, 4-phase product discovery workflow |\n| **pm-discovery** | PM Team | Opportunity Solution Tree analysis, market/user discovery |\n| **pm-strategy** | PM Team | Value Proposition (JTBD), Lean Canvas business model |\n| **pm-research** | PM Team | User personas, competitor analysis, market sizing (TAM/SAM/SOM) |\n| **pm-prd** | PM Team | PRD synthesis, beachhead segment, GTM strategy |\n\nEach agent uses Gemini native frontmatter with configurable `model`, `tools`, `temperature`, `max_turns`, and `timeout_mins`.\n\n---\n\n## Skills (35)\n\n| Skill | Category | Trigger Examples |\n|-------|----------|-----------------|\n| **pdca** | Core | `/pdca plan`, `/pdca design`, `/pdca analyze` |\n| **starter** | Level | \"static site\", \"portfolio\", \"beginner\" |\n| **dynamic** | Level | \"login\", \"fullstack\", \"authentication\" |\n| **enterprise** | Level | \"microservices\", \"k8s\", \"terraform\" |\n| **development-pipeline** | Pipeline | \"where to start\", \"development order\" |\n| **code-review** | Quality | \"review code\", \"check quality\" |\n| **zero-script-qa** | Quality | \"test logs\", \"QA without scripts\" |\n| **mobile-app** | Platform | \"React Native\", \"Flutter\", \"iOS app\" |\n| **desktop-app** | Platform | \"Electron\", \"Tauri\", \"desktop app\" |\n| **bkit-templates** | Utility | \"plan template\", \"design template\" |\n| **bkit-rules** | Utility | Core rules (auto-applied) |\n| **gemini-cli-learning** | Learning | `/learn`, \"Gemini CLI setup\" |\n| **plan-plus** | Enhanced | \"brainstorm plan\", \"explore alternatives\" |\n| **simplify** | Quality | \"simplify code\", \"reduce complexity\" |\n| **batch** | Automation | \"batch process\", \"multiple features\" |\n| **loop** | Automation | \"recurring check\", \"monitor interval\" |\n| **output-style-setup** | Utility | \"install styles\", \"setup output\" |\n| **pm-discovery** | PM | \"product discovery\", \"PM analysis\", \"PRD\" |\n| **phase-1-schema** | Pipeline | \"schema\", \"data model\" |\n| **phase-2-convention** | Pipeline | \"coding rules\", \"conventions\" |\n| **phase-3-mockup** | Pipeline | \"mockup\", \"wireframe\", \"prototype\" |\n| **phase-4-api** | Pipeline | \"API design\", \"REST endpoints\" |\n| **phase-5-design-system** | Pipeline | \"design system\", \"component library\" |\n| **phase-6-ui-integration** | Pipeline | \"frontend integration\", \"API client\" |\n| **phase-7-seo-security** | Pipeline | \"SEO\", \"security hardening\" |\n| **phase-8-review** | Pipeline | \"architecture review\", \"gap analysis\" |\n| **phase-9-deployment** | Pipeline | \"CI/CD\", \"production deployment\" |\n| **bkend-quickstart** | bkend.ai | \"bkend setup\", \"first project\", \"MCP connect\" |\n| **bkend-auth** | bkend.ai | \"signup\", \"login\", \"JWT\", \"session\" |\n| **bkend-data** | bkend.ai | \"table\", \"CRUD\", \"schema\", \"filter\" |\n| **bkend-storage** | bkend.ai | \"file upload\", \"presigned URL\", \"CDN\" |\n| **bkend-mcp** | bkend.ai | \"MCP tools\", \"AI integration\", \"28 tools\" |\n| **bkend-security** | bkend.ai | \"RLS\", \"API keys\", \"encryption\" |\n| **bkend-cookbook** | bkend.ai | \"tutorial\", \"example project\", \"todo app\" |\n| **bkend-guides** | bkend.ai | \"troubleshooting\", \"migration\", \"environment\" |\n\nSkills use progressive disclosure -- only metadata is loaded initially, with full instructions injected when activated. Skills are classified as Workflow (W), Capability (C), or Hybrid (H) for optimal activation.\n\n---\n\n## TOML Commands (24)\n\nbkit provides 24 custom commands using Gemini CLI's TOML command format with advanced syntax:\n\n| Command | Description | Syntax Features |\n|---------|-------------|-----------------|\n| `/bkit` | Show help and available functions | Static prompt |\n| `/pdca \u003caction\u003e` | PDCA cycle management | `@{path}` file inclusion, `!{command}` shell exec, `{{args}}` interpolation |\n| `/review \u003cpath\u003e` | Code review | `@{path}` skill loading |\n| `/qa` | Zero Script QA | `@{path}` skill loading |\n| `/starter \u003caction\u003e` | Starter project commands | `@{path}` + `{{args}}` |\n| `/dynamic \u003caction\u003e` | Dynamic project commands | `@{path}` + `{{args}}` |\n| `/enterprise \u003caction\u003e` | Enterprise project commands | `@{path}` + `{{args}}` |\n| `/pipeline \u003caction\u003e` | Development pipeline | `@{path}` + `{{args}}` |\n| `/learn [topic]` | Gemini CLI learning | `@{path}` + `!{command}` + `{{args}}` |\n| `/github-stats` | GitHub repository statistics | Custom prompt |\n| `/plan-plus \u003cfeature\u003e` | Brainstorming-enhanced PDCA planning | `@{path}` + `{{args}}` |\n| `/simplify` | Code quality review and simplification | `@{path}` |\n| `/batch \u003cfeatures\u003e` | Parallel multi-feature PDCA processing | `@{path}` + `{{args}}` |\n| `/loop \u003cinterval\u003e \u003ccmd\u003e` | Recurring command execution | `@{path}` + `{{args}}` |\n| `/output-style-setup` | Install output style files | `@{path}` |\n| `/pm-discovery \u003cfeature\u003e` | PM Agent Team product analysis | `@{path}` + `{{args}}` |\n| `/bkend-quickstart` | bkend.ai platform onboarding | `@{path}` + `{{args}}` |\n| `/bkend-auth` | bkend.ai authentication guide | `@{path}` + `{{args}}` |\n| `/bkend-data` | bkend.ai database operations | `@{path}` + `{{args}}` |\n| `/bkend-storage` | bkend.ai file storage guide | `@{path}` + `{{args}}` |\n| `/bkend-mcp` | bkend.ai MCP tools \u0026 AI | `@{path}` + `{{args}}` |\n| `/bkend-security` | bkend.ai security policies | `@{path}` + `{{args}}` |\n| `/bkend-cookbook` | bkend.ai project tutorials | `@{path}` + `{{args}}` |\n| `/bkend-guides` | bkend.ai operational guides | `@{path}` + `{{args}}` |\n\n### TOML Advanced Syntax\n\n```toml\n# Example: pdca.toml\ndescription = \"PDCA cycle management\"\nprompt = \"\"\"\n@skills/pdca/SKILL.md           # @{path} - Include file content\nExecute PDCA action: {{args}}    # {{args}} - User argument interpolation\nCurrent status:\n!cat docs/.pdca-status.json      # !{command} - Shell command execution\n\"\"\"\n```\n\n---\n\n## Tool Name Mapping\n\nbkit uses Gemini CLI native tool names (v0.29.0+ verified from source):\n\n| Claude Code Tool | Gemini CLI Tool |\n|------------------|-----------------|\n| Write | write_file |\n| Edit | replace |\n| Read | read_file |\n| Bash | run_shell_command |\n| Glob | glob |\n| Grep | grep_search |\n| WebSearch | google_web_search |\n| WebFetch | web_fetch |\n| AskUserQuestion | ask_user |\n| Skill | activate_skill |\n| TodoWrite | write_todos |\n| SaveMemory | save_memory |\n| EnterPlanMode | enter_plan_mode |\n| ExitPlanMode | exit_plan_mode |\n| TaskCreate | tracker_create_task |\n| TaskUpdate | tracker_update_task |\n| TaskGet | tracker_get_task |\n| TaskList | tracker_list_tasks |\n\n---\n\n## Language Support\n\nbkit automatically detects your language from trigger keywords in 8 languages:\n\n| Language | Trigger Keywords |\n|----------|-----------------|\n| English | static website, beginner, API design, verify, analyze |\n| Korean | 정적 웹, 초보자, API 설계, 검증, 분석 |\n| Japanese | 静的サイト, 初心者, API設計, 確認, 分析 |\n| Chinese | 静态网站, 初学者, API设计, 验证, 分析 |\n| Spanish | sitio web estatico, principiante, verificar |\n| French | site web statique, debutant, verifier |\n| German | statische Webseite, Anfanger, prufen |\n| Italian | sito web statico, principiante, verificare |\n\n---\n\n## Updating bkit Extension\n\n### Via CLI (Recommended)\n\n```bash\ngemini extensions install https://github.com/popup-studio-ai/bkit-gemini.git\n```\n\nThis reinstalls the extension with the latest version from the repository.\n\n### Manual Update\n\n```bash\ncd ~/.gemini/extensions/bkit \u0026\u0026 git pull origin main\n```\n\n### Verify Update\n\n```bash\n# Check extension list\n/extensions list\n\n# Verify version\n/bkit\n```\n\n### Development Mode\n\nFor local development, use the `link` command to avoid reinstalling after every change:\n\n```bash\ngemini extensions link /path/to/local/bkit-gemini\n```\n\nIn Gemini CLI v0.28.2+, you can use the following command to refresh agents and skills without restarting:\n\n```bash\n/agents refresh\n```\n\n---\n\n## Security \u0026 Permissions (v0.28.2+)\n\nGemini CLI v0.28.2 introduces strict security warnings for extensions using hooks. When installing or activating `bkit`, you may see warnings about tool interception.\n\n**Why bkit uses hooks:**\n- **PDCA Context**: To automatically track development phases and update `.pdca-status.json`.\n- **Memory Management**: To persist agent-specific context across sessions.\n- **Intent Detection**: To intelligently trigger the right agents based on your prompt.\n\nThese hooks are non-interactive, performance-optimized, and essential for the Context Engineering features of bkit.\n\n---\n\n## Compatibility\n\n| Requirement | Version |\n|-------------|---------|\n| Gemini CLI | v0.29.0+ (forward-compatible with v0.33.x Task Tracker + Extension Policies) |\n| Node.js | v18+ (for hook scripts) |\n| Git | Any recent version |\n\n### Gemini CLI Feature Utilization\n\n| Gemini CLI Feature | bkit Usage |\n|-------------------|-----------|\n| Agent frontmatter (model, tools, temperature, max_turns, timeout_mins) | All 21 agents |\n| 10 Hook Events | All 10 events registered with matcher patterns |\n| @import syntax | 7 context modules in `.gemini/context/` |\n| TOML commands with `@{}`, `!{}`, `{{}}` | 24 enhanced commands |\n| Agent Skills (GA since v0.26.0) | 35 skills with progressive disclosure |\n| MCP servers | 6 tools via `spawn-agent-server.js` |\n| Extension manifest `settings` | 2 user-configurable options |\n| `${extensionPath}` variable | Used in hooks.json for portable paths |\n\n---\n\n## Documentation\n\n### Component Reference\n\n- [Development Pipeline](skills/development-pipeline/SKILL.md) -- 9-stage pipeline skill\n- [Skills Reference](skills/) -- 35 domain skills\n- [Agents Reference](agents/) -- 21 specialized agents\n- [Changelog](CHANGELOG.md) -- Complete version history\n\n### PDCA Documents\n\n- [Plans](docs/01-plan/features/) -- Feature plan documents\n- [Designs](docs/02-design/features/) -- Feature design documents\n- [Reports](docs/04-report/) -- PDCA completion reports\n\n---\n\n## Relationship to bkit-claude-code\n\nbkit-gemini is a fork of [bkit-claude-code](https://github.com/popup-studio-ai/bkit-claude-code), adapted for Gemini CLI compatibility. Key differences:\n\n| Aspect | bkit-claude-code | bkit-gemini |\n|--------|-----------------|-------------|\n| Platform | Claude Code | Gemini CLI |\n| Context file | CLAUDE.md | GEMINI.md |\n| Tool names | Write, Edit, Read, Bash | write_file, replace, read_file, run_shell_command |\n| Variables | N/A | `${extensionPath}`, `${workspacePath}` |\n| Hooks | Claude Code hooks | Gemini CLI 10-event hook system |\n| Commands | Slash commands | TOML commands with `@`, `!`, `{{}}` syntax |\n| Skills | Native skills | Skills (GA since v0.26.0) |\n| Agent format | .md with custom fields | .md with Gemini native frontmatter |\n\n---\n\n## Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n### Branch Protection\n\n- Only `admin` team members can merge to `main`\n- All changes require pull request review\n- Version releases are managed through Git tags\n\n---\n\n## License\n\nCopyright 2024-2026 POPUP STUDIO PTE. LTD.\n\nLicensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.\n\nYou must include the [NOTICE](NOTICE) file in any redistribution.\n\n---\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/popup-studio-ai/bkit-gemini/issues)\n- **Email**: contact@popupstudio.ai\n\n---\n\nMade with AI by [POPUP STUDIO](https://popupstudio.ai)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpopup-studio-ai%2Fbkit-gemini","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpopup-studio-ai%2Fbkit-gemini","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpopup-studio-ai%2Fbkit-gemini/lists"}