Neurcode Governance

AI-powered code governance and plan enforcement for VS Code.

Neurcode acts as a "Scope Guard" for your project. It ensures that every line of code you write adheres to an agreed-upon plan, preventing scope creep, technical debt, and "bloat" before it enters your codebase.

⚠️ Prerequisite: Install the Engine

This extension is the interface for the Neurcode CLI. You must have the CLI installed globally for the extension to work.

npm install -g @neurcode/cli

🚀 Quick Start

Open your project in VS Code.
Initialize Neurcode (if you haven't already):

neurcode init

Generate a Plan for your next task:
- Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
- Run "Neurcode: Generate Plan"
- Describe what you want to build.
Code Away!
- As you work, Neurcode watches your changes.
- The Scope Guard will block unauthorized files or excessive changes.
Verify:
- Click "Verify Changes" in the Neurcode Sidebar to check your grade.

✨ Features

🛡️ Scope Guard: Automatically detects and blocks changes to files that were not in the approved plan.

📊 Real-time Grading: Get instant feedback (Grade A-F) on how well you are sticking to the plan.

🔓 One-Click Overrides: Need to edit a file that wasn't planned? Just hit "Allow" in the sidebar to authorize the deviation explicitly.

🧠 AI Architect: Generates detailed execution plans to guide your coding sessions.

⌨️ Commands

Command	Description
`Neurcode: Generate Plan`	Describe a task and generate a governance plan.
`Neurcode: Verify Changes`	Check your current code against the plan.
`Neurcode: Allow File`	Whitelist the currently open file (bypass Scope Guard).
`Neurcode: Refresh`	Reload the status sidebar.

❓ Troubleshooting

"Command not found: neurcode" This means the CLI is not installed or not in your system PATH. Run npm install -g @neurcode/cli and restart VS Code.

Built by Sujit Jaunjal