version: "0.5.3" last_updated: "2026-03-09" category: "user-facing" description: "Prudentia framework overview, quick start guide, and feature roadmap"

Prudentia

Wisdom in creation. Integrity in execution. Sustainability in maintenance.

Prudentia keeps your AI assistant consistent, contextual, and quality-aware — session after session. It provides structured coding standards, session continuity, and automated quality checks for AI-collaborative development.

Install

npm install -g @kerberos-interactive/prudentia-mcp
claude mcp add --scope user --transport stdio prudentia -- prudentia-mcp

Restart Claude Code. Done.

Initialize a Project

In your project directory, ask Claude Code:

"Initialize Prudentia for this project. It's a TypeScript project using React."

Prudentia creates three things:

your-project/
├── .prudentia/
│   ├── config/
│   │   └── project.yaml   # Your project config (languages, frameworks, etc.)
│   └── living/
│       └── STATE.md        # Project brain (~500 tokens, persists between sessions)
└── CLAUDE.md               # Auto-loads Prudentia context at session start

What You Get

Session Continuity

Every session starts with prudentia_get_context (triggered automatically via CLAUDE.md). One call loads:

• Prudentia standards and quality rules
• Your language/framework extensions
• Current project state (what you were working on, recent decisions, next steps)
• Any active living documents

The AI picks up exactly where you left off, no re-explanation needed.

Code Quality Standards

The AI follows enforceable rules from prudentia-rules.yaml:

• Cyclomatic complexity ≤10 per function
• Function length ≤50 lines
• Test coverage ≥90% for new code
• Conventional Commits format
• Semantic Versioning

Language Extensions

Best practices loaded automatically based on your project config:

Languages: Python, JavaScript, TypeScript, Go, Rust

Frameworks: FastAPI, React, Next.js

Living Documents

Created lazily — only when they have content:

• STATE.md — Project brain. Created at init. Updated as you work.
• CHECKPOINT.md — Session checkpoints. Created on first checkpoint.
• TODO.md, DECISIONS.md, ROADMAP.md — Created when first written.

13 MCP Tools

| Tool | Purpose | |------|---------| | prudentia_get_context | Load full session context — call this at session start | | prudentia_init_project | Initialize .prudentia/ in a project | | prudentia_update_state | Update STATE.md with current work, decisions, next steps | | prudentia_update_doc | Create or update a living document | | prudentia_checkpoint_session | Save session checkpoint | | prudentia_get_rules | Query rules by category or language | | prudentia_get_extension | Load a language or framework extension | | prudentia_list_extensions | List all available extensions | | prudentia_add_languages | Add languages to an existing project | | prudentia_get_project_config | Get project configuration | | prudentia_get_context_usage | Monitor context window usage | | prudentia_check_updates | Check for Prudentia updates on GitHub | | prudentia_update | Update templates (preserves your config) |

Documentation

• Getting Started — Step-by-step setup
• MCP Setup — Claude Code integration details
• Contributing — Adding extensions and improvements

Manual Setup (No MCP)

Works with any AI assistant. Copy the templates to your project:

Windows (PowerShell):

Copy-Item -Recurse C:\path\to\Prudentia\mcp-server\templates\.prudentia -Destination C:\path\to\your\project\

Mac/Linux:

cp -r /path/to/Prudentia/mcp-server/templates/.prudentia /path/to/your/project/

Then tell your AI: "I'm using the Prudentia framework. Read .prudentia/PROMPT.md and follow those guidelines."

Roadmap

v0.5.3 ✅ (Current) — npm page polish: front matter strip, link rewriting, --version flag

v0.5.2 ✅ — npm publish workflow automation, README single source of truth

v0.5.1 ✅ — Tech debt cleanup, Go + Rust extensions, npm publish

v0.5.0 ✅ — Lazy init + prudentia_get_context (13 MCP tools)

v0.4.x ✅ — MCP server, 96% test coverage, non-code project support, session continuity tools

v1.0.0 — Public release after real-world testing and refinement

Contributing

Extensions are the easiest way to contribute. See CONTRIBUTING.md for guidelines.

High priority: Java, C#, Ruby, Django, Vue, Svelte extensions.

License

Mozilla Public License 2.0 — your project code stays under your own license. Only modifications to Prudentia itself require MPL-2.0.

Built with wisdom. Maintained with integrity. Designed for sustainability.