nt8-sdk/.kilocode/rules/project_context.md

Project Context - NT8 SDK

Last Updated: 2026-04-05

Mission: ship safe, compile-stable NT8 trading software with strict scope control and durable governance documentation.

Session Start (Mandatory)

• Read these files first, in order:
  1. docs/00-governance/executive_summary.md
  2. docs/00-governance/current_status.md
  3. docs/00-governance/active_work.md
  4. docs/00-governance/architecture.md
  5. docs/00-governance/roadmap.md
• Treat docs/00-governance/* as canonical for current direction.

Historical/Contextual Sources (Non-Canonical)

Use only for background unless explicitly requested in task scope:

• README.md
• docs/README.md
• PROJECT_HANDOVER.md
• DESIGNED_VS_IMPLEMENTED_GAP_ANALYSIS.md
• docs/INDEX.md

File Touch Scope (Hard Rules)

• Modify only files explicitly listed in the task spec.
• Do not edit adjacent files for cleanup or style-only changes.
• If a required fix is outside scope, stop and record a scope blocker.
• Respect .kilocode/rules/file_boundaries.md at all times.

Conversation Separation (Hard Rules)

• Strategy conversations: entry/exit logic and behavior.
• Architecture conversations: cross-component design and interfaces.
• Coding conversations: implementation details and diffs.
• Do not mix decisions across tracks; record architecture decisions in docs/00-governance/decisions.md.

Documentation Sync Triggers

Update governance docs as part of normal task completion:

• Update docs/00-governance/active_work.md when current priorities, status, blockers, or ownership change.
• Update docs/00-governance/roadmap.md when milestone sequence, scope, or timing changes.
• Update docs/00-governance/decisions.md when a durable tradeoff or architecture decision is made.
• Update CLEANUP_LOG.md when cleanup debt is created, resolved, or deferred.

Compatibility and Safety Baselines

• C# 5.0 only (.kilocode/rules/csharp_50_syntax.md).
• NT8 compile safety (.kilocode/rules/ninjascript_guardrails.md, .kilocode/rules/nt8compilespec.md).
• Verification gates (.kilocode/rules/verification_requirements.md).