knowzcode

KnowzCode

Structured AI Development.

What You Get · How It Works · Install · Quick Start · Platforms

AI coding assistants lack structure. Without it, they forget context between sessions, skip tests, make changes without considering impact, and declare "done" without verifying anything works.

KnowzCode brings discipline to AI-assisted development — quality gates, test-driven workflows, and session continuity that keeps complex projects on track.

What You Get

• Quality gates that catch issues before they compound
• Tests written before code, verified against requirements
• Living documentation that updates as code changes
• Session continuity — pick up exactly where you left off, even days later
• Complexity-aware — quick fixes skip ceremony, complex features get full rigor
• Works on 6 AI platforms — not locked to any single tool
• Connected to your knowledge base — past decisions inform future work (optional)
• Autonomous mode — approve the plan upfront, then let the AI run with safety guardrails

When to Use It

KnowzCode adds overhead. Here's when it's worth it:

Your agent's native mode is fine for: single-file changes, small refactors, anything you can verify at a glance.

Reach for KnowzCode when:

• Outcomes aren't meeting expectations — the agent keeps missing edge cases or delivering incomplete work
• Multi-component changes — features that touch API + database + UI + tests
• Architecture and security matter
• You need documentation that stays current
• Long-running work that spans sessions

The overhead pays for itself when the cost of getting it wrong exceeds the cost of being thorough.

How It Works

  Goal → Analyze → ✓ → Design → ✓ → Build & Test → Audit → ✓ → Ship

  ✓ = approval gate (you decide whether to proceed)

Step	What Happens
Analyze	Scans your codebase for impact — what files change, what could break, what patterns to follow
Design	Drafts specifications with requirements and test criteria. You review before any code is written
Build & Test	Tests first, then code. Verification loops catch regressions
Audit	Quality review covering code quality, security, test coverage, and adherence to your standards
Ship	Commits, updates documentation, and captures learnings

KnowzCode automatically classifies tasks by complexity:

Tier	When	What Happens
Quick Fix	Single file, small bug	Skips the loop. Fix, verify, done
Light	3 files or fewer	Streamlined two-step path
Full	Complex features	Complete loop with all gates

Install

# Claude Code (recommended)
/plugin marketplace add knowz-io/knowz-skills
/plugin install knowzcode@knowz-skills
cd your-project/
/knowzcode:init

# All platforms
npx knowzcode                                    # Interactive setup
npx knowzcode install --platforms claude,gemini   # Specific platforms
npx knowzcode install --platforms all             # All 6 platforms

Quick Start

# Build a feature (full loop)
/knowzcode:work "Build user authentication with email and password"

# Research first, build later
/knowzcode:explore "how is authentication implemented?"

# Quick fix (skips the loop)
/knowzcode:fix "Fix typo in login button text"

# Resume where you left off
/knowzcode:continue

Commands

Command	Description
/knowzcode:work <goal>	Start a feature workflow
/knowzcode:explore <topic>	Research before implementing
/knowzcode:fix <target>	Quick targeted fix
/knowzcode:audit [type]	Run quality audits
/knowzcode:init	Initialize in your project
/knowzcode:status	Check project status
/knowzcode:continue	Resume active work
/knowzcode:telemetry	Investigate production errors

Platform Support

Full support:

Platform	Install
Claude Code	/plugin install knowzcode@knowz-skills
OpenAI Codex	npx knowzcode install --platforms codex
Gemini CLI	npx knowzcode install --platforms gemini

Experimental:

Platform	Install
GitHub Copilot	npx knowzcode install --platforms copilot
Cursor	npx knowzcode install --platforms cursor
Windsurf	npx knowzcode install --platforms windsurf

Connected to Knowz

KnowzCode optionally connects to Knowz for persistent knowledge across projects:

• Past decisions are searchable — "Why did we choose JWT over sessions?" gets a real answer
• Learnings captured automatically as you work
• Conventions from one project inform work on another

Works fully without Knowz. The connection adds memory, not dependency.

Acknowledgments

KnowzCode builds upon the Noderr project by @kaithoughtarchitect.

License

MIT License with Commons Clause — See LICENSE for details.

Full capabilities · Documentation · knowz.io