Pre-cleanup baseline snapshot

.kilocode/rules/development_workflow.md

@@ -1,7 +1,108 @@
-# NT8 Institutional SDK - Development Workflow
+# NT8-SDK — Kilocode Development Workflow
+**Last Updated:** 2026-03-27
 
-## Overview
-This document outlines the development workflow for the NT8 Institutional SDK, following the Archon workflow principles even in the absence of the Archon MCP server.
+This is the authoritative workflow for all development work on NT8-SDK using Kilocode.
+
+---
+
+## Division of Labor
+
+| Role | Responsibility |
+|---|---|
+| **Claude** | Architecture, diagnosis, Kilocode prompt authoring, sequencing |
+| **Kilocode** | ALL code implementation — zero exceptions |
+| **Mo** | Strategy direction, backtest execution, log collection, go/no-go |
+
+---
+
+## Per-Task Workflow
+
+1. **Claude writes Kilocode prompt** — exact Find/Replace, both file paths, build command, validation checklist
+2. **Mo runs Kilocode** — pastes prompt, Kilocode executes
+3. **Kilocode reports** — build output + files changed
+4. **Mo brings results to Claude** — Kilocode report + session log + CSV
+5. **Claude diagnoses** — confirms or issues follow-up prompt
+6. **Mo commits:** `git add` → `git commit` → `git push`
+7. **Update SPRINT_BOARD** — task to Done or Blocked
+
+---
+
+## Kilocode Prompt Template
+
+```
+TASK: [one-line description]
+
+CONTEXT:
+[1-3 sentences explaining why]
+
+FILES TO MODIFY:
+1. C:\dev\nt8-sdk\src\...                              [repo path]
+2. C:\Users\billy\...\Strategies\...                  [NT8 path — same change]
+
+CHANGE 1 — [description]:
+File: [path]
+Find:
+[exact existing code]
+Replace with:
+[new code]
+
+BUILD & DEPLOY:
+1. dotnet build NT8-SDK.sln --configuration Release
+2. deployment\deploy-to-nt8.bat
+3. NT8: Tools → Edit NinjaScript → open NT8StrategyBase.cs → save
+
+VALIDATION:
+- Run Strategy Analyzer: NQ JUN26, Jan 1 2026 → Mar 27 2026
+- Look for in session log: [specific confirmation lines]
+```
+
+---
+
+## Guardrails — Kilocode MUST NEVER
+
+1. Modify files outside the task spec
+2. Use C# 6+ syntax
+3. Remove existing comments or XML documentation
+4. Change interface signatures
+5. Deploy without building first
+6. Edit NT8 path without also updating repo path
+7. Guess NT8 API signatures
+8. Introduce async/await
+
+---
+
+## Log Analysis Quick Reference
+
+**Healthy dual-leg trade in session log:**
+```
+SIGNAL Sell | Grade=A | Score=0.820
+SUBMIT Scaler=1 Runner=1 Stop=8 Target=20
+FILL Short 1 @ XXXXX            <- scaler fill
+PNL_UPDATE Position=Short Qty=1
+FILL Short 1 @ XXXXX            <- runner fill
+PNL_UPDATE Position=Short Qty=2  <- CRITICAL: Qty=2 = runner entered
+```
+
+**Warning signs:**
+- SUBMIT then only 1 FILL → runner blocked (check EntriesPerDirection + MaxOpenPositions)
+- Multiple SIGNALs in milliseconds → replay burst (_realtimeBarSeen not working)
+- SIGNAL then nothing → ProcessStrategyIntent guard blocking backtest
+
+---
+
+## Commit Message Format
+
+```
+feat: description     <- new feature
+fix: description      <- bug fix
+refactor: description <- no behavior change
+test: description     <- tests only
+docs: description     <- documentation only
+```
+
+---
+
+## Original Archon Workflow (2025, archived below)
 
 ## Archon Workflow Principles