### User Interaction: Project Start

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/agents/pipeline-guide.md

Example of initial user interaction to gauge experience level and determine the appropriate guidance approach.

```plaintext
"Hello! What kind of project do you want to create?

How much development experience do you have?
1. I'm new → Proceed with 9-step guide
2. I've done some → Guide only necessary parts
3. I'm experienced → Proceed freely"
```

--------------------------------

### Install bkit-gemini via CLI

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/README.md

Recommended method for installing the extension using the Gemini CLI.

```bash
gemini extensions install https://github.com/popup-studio-ai/bkit-gemini.git
```

--------------------------------

### Install bkit-gemini manually

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/README.md

Alternative installation method by cloning the repository directly into the extensions directory.

```bash
git clone https://github.com/popup-studio-ai/bkit-gemini.git ~/.gemini/extensions/bkit
```

--------------------------------

### Install bkit Gemini CLI Extension

Source: https://context7.com/popup-studio-ai/bkit-gemini/llms.txt

Install the bkit extension using the Gemini CLI or manually clone the repository. Verify the installation by listing extensions.

```bash
# CLI Install (Recommended)
gemini extensions install https://github.com/popup-studio-ai/bkit-gemini.git

# Manual Install
git clone https://github.com/popup-studio-ai/bkit-gemini.git ~/.gemini/extensions/bkit

# Verify Installation
/extensions list
/bkit
```

--------------------------------

### Install bkit extension

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/docs/03-analysis/gemini-cli-031-feature-enhancement-proposals.analysis.md

Use this command to install the bkit extension. Ensure you are in the correct project directory.

```bash
gemini extensions install bkit
```

--------------------------------

### Setup MFA

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/bkend-auth/SKILL.md

Initiates the Multi-Factor Authentication (MFA) setup process for the user.

```APIDOC
## POST /auth/mfa/setup

### Description
Initiates the Multi-Factor Authentication (MFA) setup process for the user.

### Method
POST

### Endpoint
/auth/mfa/setup

### Headers
- **Authorization** (string) - Required - Bearer <access-token>

### Response
#### Success Response (200 OK)
- **success** (boolean) - Indicates if the request was successful.
- **data** (object) - Contains MFA setup details.
  - **secret** (string) - The secret key for the TOTP authenticator app.
  - **qrCodeUrl** (string) - The URL for generating the QR code to add the account to an authenticator app.
  - **backupCodes** (array of strings) - A list of backup codes for MFA recovery.

#### Response Example
```json
{
  "success": true,
  "data": {
    "secret": "JBSWY3DPEHPK3PXP",
    "qrCodeUrl": "otpauth://totp/bkend:user@example.com?secret=JBSWY3DPEHPK3PXP&issuer=bkend",
    "backupCodes": [
      "abc123def456",
      "ghi789jkl012",
      "mno345pqr678",
      "stu901vwx234",
      "yza567bcd890"
    ]
  }
}
```
```

--------------------------------

### Verify bkit-gemini installation

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/README.md

Commands to list installed extensions and access bkit help.

```bash
# In interactive mode
/extensions list

# Or in non-interactive mode
gemini extensions list

# View bkit help
/bkit
```

--------------------------------

### Navigate and Start Gemini CLI

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/tests/gemini-interactive-tests.md

Navigate to the test project directory and start the Gemini CLI. Follow the subsequent test cases for interactive execution.

```bash
# 1. Navigate to test project
cd /tmp/bkit-test-project

# 2. Start Gemini CLI
gemini

# 3. Follow the test cases below
```

--------------------------------

### Communication Examples

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/agents/starter-guide.md

Examples of effective and ineffective communication styles for beginners.

```text
"Let's open the index.html file.
This file is the 'first page' of the website.
It's the first screen you see when you access the website in a browser.

Would you like to open this file and check it now?"
```

```text
"Modify index.html. After the DOCTYPE declaration, add
meta tags and link tags to the head section, and structure
the body with semantic HTML."
```

--------------------------------

### Initialize Expo Project

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/mobile-app/SKILL.md

Commands to create and start a new Expo project.

```bash
# Create new Expo project
npx create-expo-app my-app
cd my-app
npx expo start
```

--------------------------------

### Install and Manage bkit Extension

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/README.md

Commands for installing, updating, and linking the bkit extension via the Gemini CLI.

```bash
gemini extensions install https://github.com/popup-studio-ai/bkit-gemini.git
```

```bash
cd ~/.gemini/extensions/bkit && git pull origin main
```

```bash
# Check extension list
/extensions list

# Verify version
/bkit
```

```bash
gemini extensions link /path/to/local/bkit-gemini
```

```bash
/agents refresh
```

--------------------------------

### Install UI Components

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/templates/pipeline/phase-5-design-system.template.md

Command line instructions for adding components using the shadcn/ui CLI.

```bash
# shadcn/ui component installation log
npx shadcn@latest add button
npx shadcn@latest add input
npx shadcn@latest add card
# ...
```

--------------------------------

### QA Phase Command Examples

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/qa-phase/SKILL.md

Examples of commands used to trigger QA testing at different levels.

```text
/qa-phase user-auth
```

```text
/qa-phase user-auth --level L1
```

```text
/qa-phase user-auth --level L3
```

```text
/qa-phase user-auth --level L5
```

--------------------------------

### JSON-RPC Protocol Example - Request

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/docs/02-design/features/v2.0.4-enhancement.design.md

An example JSON-RPC request for the 'tools/call' method, specifically for 'bkit_qa_run'.

```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "bkit_qa_run",
    "arguments": {
      "feature": "user-auth",
      "projectDir": "/home/user/my-project",
      "levels": [1, 2],
      "testPattern": "**/*.test.js"
    }
  }
}
```

--------------------------------

### Email Signup with bkendFetch

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/bkend-auth/SKILL.md

Example implementation of the signup process using the bkendFetch utility.

```typescript
const result = await bkendFetch("/auth/email/signup", {
  method: "POST",
  body: JSON.stringify({
    email: "user@example.com",
    password: "SecureP@ss123",
    name: "Alice Kim",
  }),
});

// Store tokens
const { accessToken, refreshToken } = result.data.tokens;
```

--------------------------------

### Folder Structure Example

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/templates/pipeline/phase-2-convention.template.md

Illustrates a typical feature-based folder structure for organizing project files.

```tree
src/
├── components/         # Reusable components
│   ├── ui/            # Basic UI components
│   └── common/        # Common components
├── features/          # Feature-based modules
│   └── {{feature}}/
│       ├── components/
│       ├── hooks/
│       └── types.ts
├── hooks/             # Common custom hooks
├── utils/             # Utility functions
├── types/             # Global type definitions
├── constants/         # Constants
└── styles/            # Global styles
```

--------------------------------

### JSON-RPC Protocol Example for bkit_iterate

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/docs/02-design/features/v2.0.4-enhancement.design.md

Examples of JSON-RPC requests and responses for the bkit_iterate tool, demonstrating its usage for iterative feature development and gap analysis.

```APIDOC
## JSON-RPC Protocol Example: bkit_iterate

### Description
This section provides examples of JSON-RPC requests and responses for the `bkit_iterate` tool. It illustrates the process of iterative development, including identifying gaps and reaching target match rates.

### Request (1st iteration)
```json
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "bkit_iterate",
    "arguments": {
      "feature": "user-auth",
      "projectDir": "/home/user/my-project",
      "designPath": "docs/02-design/features/user-auth.design.md",
      "targetMatchRate": 90
    }
  }
}
```

### Response (gaps found)
```json
{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"status\":\"gaps_found\",\"iterationCount\":1,\"maxIterations\":5,\"matchRate\":65,\"targetMatchRate\":90,\"gaps\":[{\"type\":\"structural\",\"severity\":\"high\",\"description\":\"Expected file missing: src/auth/middleware.js\",\"file\":\"src/auth/middleware.js\",\"line\":0},{\"type\":\"functional\",\"severity\":\"high\",\"description\":\"Expected function not found: validateToken\",\"file\":\"src/auth/token.js\",\"line\":0}],\"history\":[{\"iteration\":1,\"matchRate\":65,\"gapCount\":2,\"timestamp\":\"2026-04-09T10:00:00Z\"}],\"recommendation\":\"Fix 2 gaps and call bkit_iterate again.\"}"
      }
    ]
  }
}
```

### Request (after fixing, 2nd iteration)
```json
{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "bkit_iterate",
    "arguments": {
      "feature": "user-auth",
      "projectDir": "/home/user/my-project",
      "targetMatchRate": 90
    }
  }
}
```

### Response (target reached)
```json
{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"status\":\"target_reached\",\"iterationCount\":2,\"maxIterations\":5,\"matchRate\":95,\"targetMatchRate\":90,\"gaps\":[],\"history\":[{\"iteration\":1,\"matchRate\":65,\"gapCount\":2},{\"iteration\":2,\"matchRate\":95,\"gapCount\":0}],\"recommendation\":\"Target match rate achieved. Proceed to QA phase.\"}"
      }
    ]
  }
}
```
```

--------------------------------

### Deploy to Vercel

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/phase-9-deployment/SKILL.md

Commands for installing the Vercel CLI and deploying the project to production.

```bash
# Vercel deployment
npm i -g vercel
vercel deploy --prod

# Or connect GitHub for auto-deploy
```

--------------------------------

### Setup MFA Response

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/bkend-auth/SKILL.md

Returns the secret, QR code URL, and backup codes for MFA configuration.

```http
Authorization: Bearer <access-token>
```

```json
{
  "success": true,
  "data": {
    "secret": "JBSWY3DPEHPK3PXP",
    "qrCodeUrl": "otpauth://totp/bkend:user@example.com?secret=JBSWY3DPEHPK3PXP&issuer=bkend",
    "backupCodes": [
      "abc123def456",
      "ghi789jkl012",
      "mno345pqr678",
      "stu901vwx234",
      "yza567bcd890"
    ]
  }
}
```

--------------------------------

### Install Project Dependencies

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/templates/do.template.md

Commands for adding new project dependencies using npm or pnpm.

```bash
# Add any new dependencies here
npm install {package1} {package2}
# or
pnpm add {package1} {package2}
```

```bash
npm install -D {dev-package1} {dev-package2}
```

--------------------------------

### Manage Gemini CLI Extensions

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/gemini-cli-learning/SKILL.md

Commands for installing, listing, and updating extensions from GitHub.

```bash
# Install from GitHub
gemini extensions install username/extension-name

# List installed
gemini extensions list

# Update all
gemini extensions update
```

--------------------------------

### Loop Skill Usage

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/loop/SKILL.md

Examples of how to use the Loop Skill with different intervals and commands.

```APIDOC
## Loop Skill Usage Examples

### Description
Demonstrates various ways to invoke the Loop Skill with different time intervals and commands.

### Usage Examples
```
/loop 5m pdca status
/loop 10m analyze user-auth
/loop 1h git log --oneline -5
/loop check build status
```

### Interval Format

| Format | Meaning |
|--------|---------|
| `Nm` | Every N minutes (e.g., `5m` for every 5 minutes) |
| `Nh` | Every N hours (e.g., `1h` for every 1 hour) |
| `Ns` | Every N seconds (e.g., `30s` for every 30 seconds) |
| (none) | Default interval of 10 minutes |

### Stop Condition Expressions

Optional stop conditions can be specified using the `--until` flag.

```
/loop 5m --until "matchRate >= 90" analyze user-auth
/loop 1h --until "status == deployed" check deployment
```

### Safety Limits

- **Maximum iterations**: 100
- **Minimum interval**: 10 seconds
- **Timeout per command**: 5 minutes

### Stop Conditions

The loop stops automatically when:
1. Maximum iteration count (100) is reached.
2. The user explicitly requests a stop.
3. The command returns a fatal error 3 times consecutively.
4. A stop condition expression evaluates to true.
```

--------------------------------

### Initialize Starter Project

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/starter/SKILL.md

Use this command to initialize a new project with the Starter skill. Follow the subsequent command to begin the development pipeline.

```bash
# Initialize Starter project
/starter init
```

```bash
# Follow the 9-phase pipeline
/development-pipeline start
```

--------------------------------

### Implement Next.js API Routes

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/phase-4-api/SKILL.md

Example implementation of GET and POST handlers for a user resource using Next.js App Router.

```typescript
// app/api/users/route.ts
import { NextRequest, NextResponse } from 'next/server';

export async function GET(request: NextRequest) {
  const users = await db.user.findMany();
  return NextResponse.json(users);
}

export async function POST(request: NextRequest) {
  const body = await request.json();
  const user = await db.user.create({ data: body });
  return NextResponse.json(user, { status: 201 });
}
```

--------------------------------

### Robots.txt Configuration

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/templates/pipeline/phase-7-seo-security.template.md

Configure the robots.txt file to guide search engine crawlers. This example allows all user agents to access all paths and specifies the sitemap URL.

```typescript
// app/robots.ts
export default function robots() {
  return {
    rules: { userAgent: '*', allow: '/' },
    sitemap: '{{siteUrl}}/sitemap.xml',
  }
}
```

--------------------------------

### Starter Guide Agent Test

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/tests/gemini-interactive-tests.md

Test the starter-guide agent by requesting beginner-friendly guidance on web development. Verifies the agent is invoked and provides appropriate guidance.

```bash
I'm a beginner, help me understand web development
```

--------------------------------

### Hook Output Format Examples

Source: https://context7.com/popup-studio-ai/bkit-gemini/llms.txt

Defines the expected JSON output format for hook scripts. Includes decisions, system messages, and metadata for session start, and decisions/reasons for tool-related hooks.

```javascript
// SessionStart hook output (session-start.js)
{
  "decision": "allow",
  "systemMessage": "bkit Vibecoding Kit v2.0.4 activated (Gemini CLI) - Level: Dynamic\n## PDCA Core Rules...",
  "metadata": {
    "version": "2.0.4",
    "platform": "gemini",
    "level": "Dynamic",
    "primaryFeature": "user-auth",
    "currentPhase": "design",
    "outputStyle": "bkit-pdca-guide",
    "isReturningUser": true,
    "sessionCount": 5,
    "geminiCliFeatures": { "version": "0.36.0", "hasNativeSkills": true }
  }
}

// BeforeTool hook output (permission check)
{
  "decision": "allow",  // or "block"
  "reason": "Permission denied: Matches deny pattern (*.env)"
}
```

--------------------------------

### Initialize Enterprise Project

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/enterprise/SKILL.md

Use this command to start a new enterprise-grade project. It sets up the foundational structure for microservices and infrastructure management.

```bash
/enterprise init
```

--------------------------------

### Development Pipeline Phases (Starter)

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/development-pipeline/SKILL.md

Illustrates the sequence of phases for a Starter (Static Web) development approach. This path skips API and Design System phases.

```text
Phase 1 → 2 → 3 → 6 → 9
(Skip: 4, 5, 7, 8)
```

--------------------------------

### PDCA Iterator Usage Examples

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/agents/pdca-iterator.md

Common command-line usage examples for the PDCA iterator.

```text
/pdca iterate login
→ Runs gap analysis, quality check, and iterates until passing
```

```text
/pdca iterate login --evaluator gap
→ Only runs design-implementation gap analysis

/pdca iterate login --evaluator quality
→ Only runs code quality analysis
```

```text
/pdca iterate login --threshold 95
→ Requires 95% match rate instead of default 90%
```

```text
/pdca iterate login --full
→ Runs all evaluators (gap + quality + functional)
```

--------------------------------

### Create New Project with bkend

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/bkend-cookbook/SKILL.md

Use this command in the bkend Console or MCP tool to initialize a new project. Replace 'my-blog' with your desired project name.

```bash
> Create a new project called "my-blog"
```

--------------------------------

### Initialize project levels

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/README.md

Commands to initialize projects at different complexity levels.

```bash
/starter init <name>     # Static website (Starter level)
/dynamic init <name>     # Fullstack with BaaS (Dynamic level)
/enterprise init <name>  # Microservices with K8s (Enterprise level)
```

--------------------------------

### JSON-RPC Protocol Example - Response

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/docs/02-design/features/v2.0.4-enhancement.design.md

An example JSON-RPC response containing test results for 'user-auth'.

```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [{
      "type": "text",
      "text": "{\"feature\":\"user-auth\",\"framework\":\"jest\",\"levels\":[{\"level\":1,\"name\":\"Unit\",\"total\":12,\"passed\":11,\"failed\":1,\"skipped\":0,\"duration\":3200}],\"summary\":{\"total\":12,\"passed\":11,\"failed\":1,\"skipped\":0},\"passRate\":92,\"reportPath\":\"docs/03-test/user-auth.qa-report.md\"}"
    }]
  }
}
```

--------------------------------

### Filter Syntax Example

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/bkend-mcp/SKILL.md

Example JSON structure for defining filters in data listing operations.

```json
{
  "filter": {
    "field": "status",
    "operator": "eq",
    "value": "active"
  }
}
```

--------------------------------

### Install TOML Parser for Node.js

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/docs/03-test/TC-06-07-command-config-test-design.md

Installs the '@iarna/toml' package, a TOML parser for Node.js, as a development dependency.

```bash
npm install --save-dev @iarna/toml
```

--------------------------------

### Test PHIL-01-01: Session Start Welcome

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/tests/gemini-interactive-tests.md

Initiate a new session in the Gemini CLI by typing a greeting. Verify that the system responds with a welcome message that includes 'bkit' or 'PDCA', and confirms project level detection.

```bash
# In Gemini CLI, type:
Hello, I'm new here
```

--------------------------------

### Starter Skill Test

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/tests/gemini-interactive-tests.md

Test the starter skill by requesting the creation of a simple portfolio website. Verifies the skill is triggered by keywords and provides a starter project guide.

```bash
I want to create a simple portfolio website
```

--------------------------------

### Gemini CLI Session Startup Verification

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/docs/02-design/features/bkit-v157-comprehensive-test.design.md

Steps to verify the initial startup of the Gemini CLI with the bkit extension.

```text
Environment: Gemini CLI v0.32.1 + bkit extension installed

Steps:
  1. Open terminal
  2. Navigate to a test project directory
  3. Run: gemini
  4. Wait for session initialization

Verify:
  □ bkit version displayed (v1.5.7)
  □ Project level detected (Starter/Dynamic/Enterprise)
  □ Previous work detection (if any .pdca-status.json)
  □ Feature suggestions shown
  □ Response language matches system locale or defaults to English
  □ No error messages in output
  □ Session start time < 5 seconds
```

--------------------------------

### Sort Syntax Example

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/bkend-mcp/SKILL.md

Example JSON structure for defining sorting parameters in data listing operations.

```json
{
  "sort": {
    "field": "createdAt",
    "order": "desc"
  }
}
```

--------------------------------

### Install JSON Schema Validator

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/docs/03-test/TC-06-07-command-config-test-design.md

Installs the 'ajv' and 'ajv-formats' npm packages, which are required for JSON schema validation.

```bash
npm install --save-dev ajv ajv-formats  # JSON Schema validator

```

--------------------------------

### Create Tables with bkend

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/bkend-cookbook/SKILL.md

Define and create tables for your project using the specified column types and requirements. This example shows creating 'users', 'posts', and 'comments' tables.

```bash
> Create a "users" table with columns: name (string, required), email (string, required), avatar (string)
```

```bash
> Create a "posts" table with columns: title (string, required), content (string, required), authorId (string, required), status (string, required), tags (array)
```

```bash
> Create a "comments" table with columns: content (string, required), postId (string, required), authorId (string, required)
```

--------------------------------

### Create Test Project Utility

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/docs/02-design/features/test-code-simplification.design.md

Initializes a standard v2.0.2 project structure with required directories and default status files.

```javascript
function createTestProject(fixtures = {}) {
  // Standard v2.0.2 structure always ensured
  const dirs = [
    'src', '.bkit/state', '.gemini/policies',
    'docs/01-plan/features', 'docs/02-design/features',
    'docs/03-analysis/features', 'docs/04-report/features',
    'docs/.pdca-snapshots'
  ];
  // ... mkdir logic ...
  
  // Status placement: root is default for v2
  const statusPath = path.join(TEST_PROJECT_DIR, '.pdca-status.json');
  if (!fixtures['.pdca-status.json']) {
    fs.writeFileSync(statusPath, JSON.stringify(DEFAULT_STATUS));
  }
}
```

--------------------------------

### JSON-RPC Protocol Request Example

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/docs/02-design/features/v2.0.4-enhancement.design.md

This is an example of a JSON-RPC request to call a tool. It specifies the method and arguments for the tool execution.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bkit_pm_run",
    "arguments": {
      "feature": "payment-v2",
      "projectDir": "/home/user/my-project"
    }
  }
}
```

--------------------------------

### Auth Event Webhook Example

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/bkend-guides/SKILL.md

Example JSON payload for an authentication event, such as a user registration. This format is used for callbacks.

```json
{
  "event": "auth.user.registered",
  "user": { "_id": "user_456", "email": "new@example.com" },
  "timestamp": "2026-01-15T10:30:00Z",
  "projectId": "proj_abc123",
  "environment": "prod"
}
```

--------------------------------

### Initialize Flutter Project

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/mobile-app/SKILL.md

Commands to create and run a new Flutter project.

```bash
# Create new Flutter project
flutter create my_app
cd my_app
flutter run
```

--------------------------------

### Initialize Dynamic Project

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/dynamic/SKILL.md

Use this command to initialize a new Dynamic project. This sets up the basic structure for fullstack development with bkend.ai.

```bash
/dynamic init
```

--------------------------------

### Start Log Streaming

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/agents/qa-monitor.md

Starts streaming logs from Docker Compose services in real-time. This is the primary command for live monitoring.

```bash
# 2. Start log streaming
docker compose logs -f
```

--------------------------------

### JSON-RPC Protocol Response Example

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/docs/02-design/features/v2.0.4-enhancement.design.md

This is an example of a JSON-RPC response, indicating the result of a tool call. It includes content with execution details and status.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"feature\": \"payment-v2\", \"phases\": [{\"name\": \"discovery\", \"techStack\": [\"node\", \"express\"], \"opportunities\": []}, {\"name\": \"strategy\", \"valueProposition\": \"...\"}, {\"name\": \"research\", \"personas\": []}, {\"name\": \"synthesis\", \"outputPath\": \"docs/00-pm/payment-v2.prd.md\"}], \"status\": \"success\", \"prdPath\": \"docs/00-pm/payment-v2.prd.md\"}"
      }
    ]
  }
}
```

--------------------------------

### Show Context Files for 'do' Phase

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/tests/gemini-interactive/v201-supplement-test-prompts.md

Display the context files loaded specifically for the 'do' phase. This check confirms that the updated `tool-reference-v2.md` is used instead of the older `tool-reference.md`.

```bash
Show me what context files are loaded for the 'do' phase
```

--------------------------------

### Pipeline Guide Agent Core Principles

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/agents/pipeline-guide.md

Defines the optional nature of the guidance and a decision tree for initiating the pipeline guide based on user experience.

```plaintext
This is optional guidance. We don't force it.

"Are you new to development?" → Yes: Pipeline guide ON
                               → No: Apply PDCA only, proceed freely
```

--------------------------------

### Create New Tauri Project

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/desktop-app/SKILL.md

Use this command to initialize a new Tauri desktop application. Navigate into the project directory and start the development server.

```bash
npm create tauri-app
cd my-app
npm run tauri dev
```

--------------------------------

### Gemini Session Start Configuration

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/docs/03-analysis/features/bkit-gemini-v158-upgrade.analysis.md

Initializes a Gemini session with version information and agent routing. This configuration is crucial for starting the Gemini CLI and defining agent triggers.

```javascript
Header says "v1.5.8", pm-lead trigger in agent routing table
```

--------------------------------

### GET /users/me

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/bkend-auth/SKILL.md

Retrieves the profile of the currently authenticated user.

```APIDOC
## GET /users/me

### Description
Fetches the profile information for the currently logged-in user.

### Method
GET

### Endpoint
/users/me

### Response
#### Success Response (200)
- **success** (boolean) - Indicates success.
- **data** (object) - The user profile object.
```

--------------------------------

### GET /v1/files

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/bkend-storage/SKILL.md

Lists files associated with a specific record.

```APIDOC
## GET /v1/files

### Description
Retrieves a list of files filtered by table name and record ID.

### Method
GET

### Endpoint
/v1/files

### Parameters
#### Query Parameters
- **tableName** (string) - Required - The name of the table associated with the files.
- **recordId** (string) - Required - The ID of the record associated with the files.
```

--------------------------------

### API Client Setup

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/phase-6-ui-integration/SKILL.md

Sets up a reusable fetch function for interacting with the API. Ensure the NEXT_PUBLIC_API_URL environment variable is configured.

```typescript
// lib/api/client.ts
const API_BASE = process.env.NEXT_PUBLIC_API_URL;

export async function fetchAPI<T>(
  endpoint: string,
  options?: RequestInit
): Promise<T> {
  const res = await fetch(`${API_BASE}${endpoint}`, {
    headers: {
      'Content-Type': 'application/json',
      ...options?.headers,
    },
    ...options,
  });

  if (!res.ok) {
    throw new Error(`API Error: ${res.status}`);
  }

  return res.json();
}
```

--------------------------------

### GET /users

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/bkend-auth/SKILL.md

Lists all users with optional filtering and pagination (Admin only).

```APIDOC
## GET /users

### Description
Retrieves a paginated list of users. Admin access required.

### Method
GET

### Endpoint
/users

### Parameters
#### Query Parameters
- **page** (number) - Optional - Page number.
- **limit** (number) - Optional - Items per page.
- **sort** (string) - Optional - Sort field.
- **role** (string) - Optional - Filter by role.
- **search** (string) - Optional - Search by name or email.

### Response
#### Success Response (200)
- **success** (boolean) - Indicates success.
- **data** (array) - List of user objects.
- **meta** (object) - Pagination metadata.
```

--------------------------------

### Starter Command Recognition Test

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/tests/gemini-interactive-tests.md

Test the '/starter help' command in the Gemini CLI. Verifies that the starter skill is activated and displays guide information.

```bash
/starter help
```

--------------------------------

### Clean Architecture: Starter Structure

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/templates/pipeline/phase-2-convention.template.md

Presents a minimal folder structure for the 'Starter' level of clean architecture.

```tree
src/
├── components/     # UI
├── lib/            # Utilities
└── types/          # Types
```

--------------------------------

### GET /v1/data/{table}

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/bkend-cookbook/SKILL.md

Retrieve a list of records from a specified table.

```APIDOC
## GET /v1/data/{table}

### Description
Fetches a collection of records from the database based on the provided table name.

### Method
GET

### Endpoint
/v1/data/{table}

### Parameters
#### Path Parameters
- **table** (string) - Required - The name of the database table to query.
```

--------------------------------

### Deploy Commands

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/deploy/SKILL.md

Use these commands to initiate the deployment process for different environments. The skill provides a guided checklist before executing the actual deployment command.

```bash
/deploy dev
```

```bash
/deploy staging
```

```bash
/deploy prod
```

--------------------------------

### API Request and Response Examples

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/templates/design.template.md

JSON structures for API requests and responses.

```json
{
  "field1": "string",
  "field2": "number"
}
```

```json
{
  "id": "string",
  "field1": "string",
  "field2": "number",
  "createdAt": "2024-01-01T00:00:00Z"
}
```

--------------------------------

### Quick Commands for Project Management

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/templates/TEMPLATE-GUIDE.md

CLI commands for managing PDCA cycles, pipeline phases, and project initialization.

```bash
# PDCA Commands
/pdca-plan {feature}      # Create plan document
/pdca-design {feature}    # Create design document
/pdca-analyze {feature}   # Run gap analysis
/pdca-report {feature}    # Create completion report

# Pipeline Commands
/pipeline-start           # Start 9-phase pipeline
/pipeline-status          # Check current phase
/pipeline-next            # Go to next phase

# Project Setup
/development-pipeline        # Generate GEMINI.md
/init-starter             # Initialize Starter level project
/init-dynamic             # Initialize Dynamic level project
/init-enterprise          # Initialize Enterprise level project
```

--------------------------------

### Project Folder Structure

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/templates/pipeline/phase-3-mockup.template.md

Illustrates the standard folder structure for the mockup project. Key directories include pages, styles, scripts, and data.

```tree
mockup/
├── pages/
│   ├── index.html
│   └── ...
├── styles/
│   └── main.css
├── scripts/
│   └── app.js
└── data/
    └── *.json
```

--------------------------------

### Environment Variable Configuration

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/bkend-security/SKILL.md

Example of storing sensitive configuration in environment files.

```bash
# .env.development
BKEND_API_URL=https://api-client.bkend.ai
BKEND_PUBLIC_KEY=ak_dev_...
BKEND_SECRET_KEY=ak_dev_secret_...

# .env.production
BKEND_API_URL=https://api-client.bkend.ai
BKEND_PUBLIC_KEY=ak_prod_...
BKEND_SECRET_KEY=ak_prod_secret_...
```

--------------------------------

### TypeScript Import Order Example

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/templates/design.template.md

Demonstrates the recommended order for importing modules in TypeScript files, categorized for clarity and consistency.

```typescript
// 1. External libraries
import { useState } from 'react'
import { useQuery } from '@tanstack/react-query'

// 2. Internal absolute imports
import { Button } from '@/components/ui'
import { userService } from '@/services/user'

// 3. Relative imports
import { useLocalState } from './hooks'

// 4. Type imports
import type { User } from '@/types'

// 5. Styles
import './styles.css'
```

--------------------------------

### Filtering Query Examples

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/agents/bkend-expert.md

Syntax for applying AND/OR logic to data filtering.

```json
AND: filter={ status: { $eq: "active" }, age: { $gte: 18 } }
OR:  filter={ $or: [{ status: "active" }, { role: "admin" }] }
```

--------------------------------

### Verify MFA Request and Response

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/bkend-auth/SKILL.md

Verifies the TOTP code for setup or login.

```json
{
  "code": "123456"
}
```

```json
{
  "success": true,
  "data": {
    "message": "MFA verified successfully",
    "mfaEnabled": true
  }
}
```

--------------------------------

### Create New Electron App

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/skills/desktop-app/SKILL.md

Initialize a new Electron application using electron-forge. After creation, navigate to the project directory and start the application.

```bash
npm init electron-app@latest my-app
cd my-app
npm start
```

--------------------------------

### Communication Rules for Agent

Source: https://github.com/popup-studio-ai/bkit-gemini/blob/main/agents/starter-guide.md

Required and prohibited communication behaviors for the guide agent.

```text
✅ Always add easy explanations when using technical terms
✅ Guide through all steps one by one in detail
✅ Check "Did everything work so far?" at every step
✅ Reassure users not to panic when errors occur
✅ Provide links when screenshots or images would help
```

```text
❌ Using technical terms without explanation
❌ Explaining multiple steps at once
❌ Using expressions like "As you obviously know"
❌ Showing too long code blocks at once
```