Hinata Wiki

Appearance

Shikamaru Academy ​

  period: project
  default engine: gemini-2.5-flash
  converted: 2026-05-28

Architecture & Decision Log ​

Objective: Establish a language learning system within Hinata-Brain that replicates "Speak" app features (personalized courses, AI tutors, immersive roleplay) using purely Markdown-based commander workflows.

System Ownership & Roles ​

  CommanderRoleResponsibility

    ShikamaruThe DeanOwns `Learning/courses/`. Translates user goals into 1-week "Tactical Units" (.md).
    BrookThe PersonaOwns the Dialogue. Executes immersive roleplays based on the current Tactical Unit.
    OrochimaruThe AnalystOwns the "Error Harvest". Scans session logs for mistakes and generates "Made For You" units.
    Jimmy NeutronThe EngineerOwns the Audio Pipeline. Ensures `transcribe-audio.sh` supports hands-free practice.

Core Decisions ​

  • Decision 1: "Tactical Unit" Standard — 1-week .md files containing scenario definition, 3-5 core patterns, and 5 progressive dialogue exchanges.

  • Decision 2: "Error Harvest" Mechanic — Commanders use a [SHIKAMARU_ERROR] tag in session logs. Every Sunday, Orochimaru reads all tagged lines to create a "Weak Point Summary" → next week's "Made For You" review unit. Archive tags once harvested.

  • Decision 3: "Hands-Free" via Transcription — User records audio during practice → transcribe-audio.sh puts text into inbox → Brook reads transcription and responds in character.

Data Flow ​

  1. User Request → Shikamaru drafts Tactical Unit.

  2. Practice Session → Brook conducts Roleplay (Text or Audio).

  3. Log Generation → Commanders tag errors.

  4. Analysis → Orochimaru harvests errors.

  5. Iteration → Next Unit includes review of harvested errors.

Internal Training Manual ​

Primary Model: gemini-2.5-flash — must be used for all immersive dialogue sessions to ensure sub-3s response times and efficient audio-to-text processing.

1. The Shikamaru Standard (Course Design) ​

When the user requests a custom course, Shikamaru generates a file in Learning/courses/{language}/{unit-name}.md following the Tactical Unit template: Objective, Target Patterns (3-5), Scenario Scripts (5 exchanges with increasing difficulty).

2. The Brook Roleplay (Execution) ​

* **Adopt the Persona:** Act strictly as the character defined in the Tactical Unit.

* **In-Flow Hints:** If the user hesitates, provide a subtle hint in the target language (bracketed).

* **Seamless Corrections:** Do not stop the conversation to correct grammar. Output the corrected version in a `[Corrected: {line}]` block after your character's response.

* **Interrupt Support:** Acknowledge if the user cuts in mid-thought.

3. The Orochimaru Analyst (Error Harvest) ​

Every Sunday: (1) Grep Search for [SHIKAMARU_ERROR]. (2) Frequency Check on recurring errors. (3) Create "Made For You" 1-day drill file targeting specific errors. (4) Archive: Clear tags from logs once harvested.

4. User Interaction (Hands-Free / Live Mode) ​

  1. Auto-Watch Protocol: Jimmy Neutron monitors `inbox/pending/` for `.m4a` or `.wav` files.

  2. Instant Transcription: `transcribe-audio.sh` triggers on file arrival.

  3. Markdown Append: Transcript auto-appended to active Tactical Unit with `[User Audio Transcribed]` tag.

  4. Agent Trigger: Brook (via `gemini-2.5-flash`) reads updated file and responds instantly.

5. Decision Support Logic ​

    * **When to Discard a Pattern:** User uses it correctly 5 times in a row across 3 different sessions.

    * **When to Escalate a Unit:** User completes "Level 5: The Master" script without requiring a `[Corrected:]` block.

◆ hinata · projects/shikamaru-academy.html · phase-18 flatten