@hanzlaa/rcode 3.3.2 → 3.4.1

package/rihal/skills/core/rihal-clone-website/SKILL.md

@@ -28,6 +28,8 @@ triggers:
 argument-hint: "<url>"
 user-invocable: true
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 ## Overview
 

package/rihal/skills/core/rihal-deploy-unify/SKILL.md

@@ -12,6 +12,8 @@ triggers:
   - "deployment audit"
 user-invocable: true
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 ## Overview
 

package/rihal/skills/core/rihal-distillator/SKILL.md

@@ -9,6 +9,8 @@ triggers:
   - "compress these docs"
 user-invocable: true
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 ## Overview
 

package/rihal/skills/core/rihal-editorial-review-prose/SKILL.md

@@ -4,6 +4,8 @@ description: 'Clinical copy-editor that reviews text for communication issues. U
 triggers:
   - "editorial review prose"
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 # Editorial Review - Prose
 

package/rihal/skills/core/rihal-editorial-review-structure/SKILL.md

@@ -9,6 +9,8 @@ triggers:
   - "cut this doc down"
 user-invocable: true
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 ## Overview
 

package/rihal/skills/core/rihal-help/SKILL.md

@@ -4,6 +4,8 @@ description: 'Analyzes current state and user query to answer Rihal questions or
 triggers:
   - "help"
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 # Rihal Help
 

package/rihal/skills/core/rihal-incident-record/SKILL.md

@@ -12,6 +12,8 @@ triggers:
   - "incident summary"
 user-invocable: true
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 ## Overview
 

package/rihal/skills/core/rihal-index-docs/SKILL.md

@@ -4,6 +4,8 @@ description: 'Generates or updates an index.md to reference all docs in the fold
 triggers:
   - "index docs"
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 # Index Docs
 

package/rihal/skills/core/rihal-init/SKILL.md

@@ -6,6 +6,8 @@ argument-hint: "[--module=module_code] [--vars=var1:default1,var2] [--skill-path
 triggers:
   - "init"
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 ## Overview
 

package/rihal/skills/core/rihal-memory-audit/SKILL.md

@@ -17,6 +17,8 @@ triggers:
   - "/rcode:memory-audit"
 user-invocable: true
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 ## Overview
 

package/rihal/skills/core/rihal-memory-distill/SKILL.md

@@ -19,6 +19,8 @@ triggers:
   - "/rcode:memory-distill"
 user-invocable: true
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 ## Overview
 

package/rihal/skills/core/rihal-memory-init/SKILL.md

@@ -20,6 +20,8 @@ triggers:
   - "/rcode:memory-init"
 user-invocable: true
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 ## Overview
 

package/rihal/skills/core/rihal-memory-update/SKILL.md

@@ -20,6 +20,8 @@ triggers:
   - "/rcode:memory-update"
 user-invocable: true
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 ## Overview
 

package/rihal/skills/core/rihal-mvp-graduate/SKILL.md

@@ -12,6 +12,8 @@ triggers:
   - "ready for production"
 user-invocable: true
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 ## Overview
 

package/rihal/skills/core/rihal-ocr-consistency/SKILL.md

@@ -12,6 +12,8 @@ triggers:
   - "ocr accuracy regression"
 user-invocable: true
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 ## Overview
 

package/rihal/skills/core/rihal-party-mode/SKILL.md

@@ -73,6 +73,8 @@ Each party mode turn follows this pattern:
 {Response, may reference previous agent's point}
 
 ---
+@.rihal/references/karpathy-guidelines.md
+
 💬 What would you like to discuss next? (say "exit" to end party mode)
 ```
 

package/rihal/skills/core/rihal-rebrand/SKILL.md

@@ -12,6 +12,8 @@ triggers:
   - "company name change"
 user-invocable: true
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 ## Overview
 

package/rihal/skills/core/rihal-review-adversarial-general/SKILL.md

@@ -4,6 +4,8 @@ description: 'Perform a Cynical Review and produce a findings report. Use when t
 triggers:
   - "review adversarial general"
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 # Adversarial Review (General)
 

package/rihal/skills/core/rihal-review-edge-case-hunter/SKILL.md

@@ -4,6 +4,8 @@ description: 'Walk every branching path and boundary condition in content, repor
 triggers:
   - "review edge case hunter"
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 # Edge Case Hunter Review
 

package/rihal/skills/core/rihal-shard-doc/SKILL.md

@@ -4,6 +4,8 @@ description: 'Splits large markdown documents into smaller, organized files base
 triggers:
   - "shard doc"
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 # Shard Document
 

package/rihal/skills/core/rihal-theme-system/SKILL.md

@@ -12,6 +12,8 @@ triggers:
   - "css variable audit"
 user-invocable: true
 ---
+@.rihal/references/karpathy-guidelines.md
+
 
 ## Overview
 

package/rihal/workflows/add-tests.md

@@ -6,6 +6,7 @@ Users currently hand-craft `/rihal-quick` prompts for test generation after each
 
 <required_reading>
 Read all files referenced by the invoking prompt's execution_context before starting.
+@.rihal/references/karpathy-guidelines.md
 </required_reading>
 
 <process>

package/rihal/workflows/audit-fix.md

@@ -4,6 +4,8 @@ auto-fixable vs manual-only, spawns executor agents for fixable issues, runs tes
 after each fix, and commits atomically with finding IDs for traceability.
 </purpose>
 
+@.rihal/references/karpathy-guidelines.md
+
 <available_agent_types>
 - rihal-executor — executes a specific, scoped code change
 </available_agent_types>

package/rihal/workflows/autonomous.md

@@ -42,6 +42,7 @@ interpos audit (issue #221) — DO NOT regress.
 @.rihal/references/output-realism.md
 @rihal/brain/best-practices/no-autonomous-bypass.md
 @rihal/brain/best-practices/state-sync-rule.md
+@.rihal/references/karpathy-guidelines.md
 
 Read all files referenced by the invoking prompt's execution_context before starting.
 

package/rihal/workflows/code-review-fix.md

@@ -4,6 +4,7 @@ Auto-fix issues from REVIEW.md. Validates phase, checks config gate, verifies RE
 
 <required_reading>
 Read all files referenced by the invoking prompt's execution_context before starting.
+@.rihal/references/karpathy-guidelines.md
 </required_reading>
 
 <available_agent_types>
@@ -280,7 +281,7 @@ if [ "$AUTO_MODE" = "true" ]; then
     if [ ${#REVIEW_FILES_ARRAY[@]} -gt 0 ]; then
       FILES_CONFIG="files:"
       for f in "${REVIEW_FILES_ARRAY[@]}"; do
-        FILES_CONFIG="${FILES_CONFIG}
+        FILES_CONFIG="${FILES_CONFIG}"
   - ${f}"
       done
     fi

package/rihal/workflows/debug.md

@@ -6,6 +6,7 @@ After identifying issues, spawn one debug agent per issue. Each agent investigat
 Orchestrator stays lean: parse issues, spawn agents, collect results, synthesize findings.
 </purpose>
 
+@.rihal/references/karpathy-guidelines.md
 
 ## Step 0 — Usage check
 

package/rihal/workflows/dev-story.md

@@ -138,6 +138,7 @@ fi
 @.rihal/references/checklist-story-draft.md
 @.rihal/references/checklist-story-dod.md
 @.rihal/references/commit-conventions.md
+@.rihal/references/karpathy-guidelines.md
 ```
 
 `STORY_CONTENT`, `STORY_ID`, `STORY_TITLE`, `PERSONA`, `EFFORT` are already set from Step 0.

package/rihal/workflows/execute-sprint.md

@@ -7,6 +7,7 @@ Read STATE.md before any operation to load project context.
 Read config.json for planning behavior settings.
 
 @.rihal/references/git-integration.md
+@.rihal/references/karpathy-guidelines.md
 </required_reading>
 
 <available_agent_types>

package/rihal/workflows/execute.md

@@ -148,6 +148,7 @@ Read STATE.md before any operation to load project context.
 @.rihal/references/agent-contracts.md
 @.rihal/references/context-budget.md
 @.rihal/references/gates.md
+@.rihal/references/karpathy-guidelines.md
 </required_reading>
 
 <available_agent_types>

package/rihal/workflows/init.md

@@ -194,6 +194,86 @@ This file is a journey baseline — intentionally shallow. For deep analysis run
 
 If no code detected, write a minimal RIHLA.md with just the header and a "fresh project — no code yet" note.
 
+## Step 4b — Populate context files
+
+After writing RIHLA.md, populate the two context files that every Rihal skill reads at runtime. These files are the project's "memory bank" — without them, agents work blind.
+
+**`.rihal/context/active.md`** — Current task context and working state. Write it using the RIHLA.md scan data from Step 4:
+
+```markdown
+# Active Context
+
+**Last updated:** {ISO date}
+**Updated by:** /rihal-init
+
+## Current State
+
+- **Project:** {project_name}
+- **Primary stack:** {detected language + framework}
+- **Branch:** {git branch or "n/a"}
+- **Recent focus:** {summary from last 5 commit messages, or "fresh project"}
+
+## Active Work
+
+{If returning with --reset: summarize what was in progress from git log}
+{If existing-new-rihal: "Rihal just configured — no active work tracked yet."}
+{If fresh: "New project — no code yet."}
+
+## Key Decisions
+
+- Rihal configured with mode: {mode from Step 2}
+- Branching strategy: {strategy from Step 2}
+- Model profile: {profile from Step 2}
+
+## Open Questions
+
+_None yet. Use `/rihal-explore` or `/rihal-council` to surface questions._
+```
+
+**`.rihal/context/project-brief.md`** — High-level project description. Write it using the RIHLA.md scan data:
+
+```markdown
+# Project Brief
+
+**Project:** {project_name}
+**Created:** {ISO date}
+
+## Overview
+
+{If code exists: 3-5 sentence summary derived from README + package manifest — what the project does, who it's for, and the primary tech stack}
+{If fresh: "Project not yet started. Run `/rihal-new-project` to design it."}
+
+## Technical Stack
+
+- **Language:** {detected primary language}
+- **Framework:** {detected framework or "none detected"}
+- **Package manager:** {npm/pnpm/pip/cargo/etc or "none detected"}
+
+## Project Goals
+
+_To be refined. Run `/rihal-create-prd` for full requirements discovery._
+```
+
+Ensure the directory exists before writing:
+
+```bash
+mkdir -p .rihal/context
+```
+
+**Important:** If `--reset` is passed and the files already have user-written content beyond the template stub, preserve a backup before overwriting:
+
+```bash
+if [ -s .rihal/context/active.md ] && ! grep -q "Run \`/rihal" .rihal/context/active.md; then
+  cp .rihal/context/active.md .rihal/context/active.md.bak
+fi
+```
+
+After writing both files, refresh the memory bank fingerprint so staleness checks see the project as fresh:
+
+```bash
+node .rihal/bin/rihal-tools.cjs context refresh 2>/dev/null || true
+```
+
 ## Step 5 — Suggest the next step
 
 Print a contextual recommendation, **one line of copy-paste per suggestion** (per `.rihal/references/command-redirect-format.md`):
@@ -246,6 +326,8 @@ Silent if state tools fail.
 - [ ] `.rihal/config.yaml` written with user's answers
 - [ ] `.rihal/state.json` exists (created or preserved)
 - [ ] `.rihal/RIHLA.md` written (unless `--skip-scan` or no code)
+- [ ] `.rihal/context/active.md` populated with project state (not the placeholder stub)
+- [ ] `.rihal/context/project-brief.md` populated with project overview (not the placeholder stub)
 - [ ] State detected correctly (fresh / existing-new-rihal / returning)
 - [ ] Contextual next-step suggestion printed as single-line copy-paste
 

package/rihal/workflows/plan.md

@@ -49,6 +49,7 @@ Read all files referenced by the invoking prompt's execution_context before star
 @.rihal/references/gate-prompts.md
 @.rihal/references/agent-contracts.md
 @.rihal/references/gates.md
+@.rihal/references/karpathy-guidelines.md
 </required_reading>
 
 <available_agent_types>

package/rihal/workflows/ship.md

@@ -17,6 +17,8 @@ the plan → execute → verify → **ship** loop.
 - You are on a feature branch (not main/develop directly)
 - `gh` CLI is authenticated (`gh auth status`)
 
+@.rihal/references/karpathy-guidelines.md
+
 **This command is NOT for:**
 - Publishing npm packages → use `npm publish`
 - Creating git release tags → use `git tag -a vX.Y.Z && git push --tags`

package/rihal/workflows/sprint-planning.md

@@ -39,6 +39,7 @@ they bypass the capacity gate.
 @.rihal/references/output-format.md
 @rihal/brain/best-practices/no-autonomous-bypass.md
 @rihal/brain/best-practices/state-sync-rule.md
+@.rihal/references/karpathy-guidelines.md
 </required_reading>
 
 <output_format>

package/rihal/workflows/validate-phase.md

@@ -4,6 +4,7 @@ Audit Nyquist validation gaps for a completed phase. Generate missing tests. Upd
 
 <required_reading>
 @.rihal/references/ui-brand.md
+@.rihal/references/karpathy-guidelines.md
 </required_reading>
 
 <available_agent_types>

package/rihal/workflows/verify-phase.md

@@ -21,6 +21,7 @@ Then verify each level against the actual codebase.
 <required_reading>
 @.rihal/references/verification-patterns.md
 @.rihal/templates/verification-report.md
+@.rihal/references/karpathy-guidelines.md
 </required_reading>
 
 <process>

package/server/lib/api.js

@@ -25,6 +25,55 @@ function handleApiFiles(req, res, projectRoot) {
 
   for (const dir of ARTIFACT_DIRS) {
     const full = path.join(PLANNING_DIR, dir);
+
+    // For 'phases', create sub-groups per phase directory
+    if (dir === 'phases') {
+      let phaseDirs;
+      try { phaseDirs = fs.readdirSync(full, { withFileTypes: true }); } catch { continue; }
+      const subGroups = [];
+      for (const pd of phaseDirs) {
+        if (!pd.isDirectory() || pd.name.startsWith('.')) continue;
+        const phaseDir = path.join(full, pd.name);
+        const phaseLabel = pd.name.replace(/^\d+-/, '').replace(/-/g, ' ')
+          .replace(/\b\w/g, c => c.toUpperCase());
+        const phaseFiles = [];
+        function walkPhase(d, prefix, depth) {
+          if (depth > 3) return;
+          let entries;
+          try { entries = fs.readdirSync(d, { withFileTypes: true }); } catch { return; }
+          for (const e of entries) {
+            if (e.name.startsWith('.')) continue;
+            const rel = prefix + '/' + e.name;
+            if (e.isDirectory()) walkPhase(path.join(d, e.name), rel, depth + 1);
+            else if (e.isFile() && e.name.endsWith('.md')) {
+              const base = e.name.replace('.md', '');
+              const sprintMatch = base.match(/^\d{2}-(\d{2})-([A-Z]+)$/);
+              const dateMatch   = base.match(/^\d{4}-\d{2}-\d{2}-(.+)$/);
+              let fileLabel;
+              if (sprintMatch) {
+                fileLabel = sprintMatch[2].charAt(0) + sprintMatch[2].slice(1).toLowerCase() + ' ' + parseInt(sprintMatch[1], 10);
+              } else if (dateMatch) {
+                fileLabel = dateMatch[1].replace(/-/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
+              } else if (base === base.toUpperCase() && /^[A-Z_-]+$/.test(base)) {
+                fileLabel = base.charAt(0) + base.slice(1).toLowerCase();
+              } else {
+                fileLabel = base.replace(/-/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
+              }
+              phaseFiles.push({ label: fileLabel, path: '.planning/phases/' + pd.name + rel });
+            }
+          }
+        }
+        walkPhase(phaseDir, '', 0);
+        if (phaseFiles.length) {
+          subGroups.push({ subGroup: phaseLabel, files: phaseFiles });
+        }
+      }
+      if (subGroups.length) {
+        groups.push({ group: 'Phases', subGroups });
+      }
+      continue;
+    }
+
     const files = [];
     function walkArtifacts(d, prefix, depth) {
       if (depth > 3) return;