Changelog
All notable changes to pudo-code-system will be documented in this file.
The format is inspired by Keep a Changelog and organized for practical repository tracking.
[Unreleased]
[1.3.1] - 2026-07-12
Added
- Expose PUDO project templates, playbooks, and init choices as MCP tools (
pudo.getInitOptions, pudo.listPlaybooks, pudo.getPlaybook) to help agents guide developers in selecting workflows.
- Include
"playbooks/" and "workflows/" folders in the root npm files list, ensuring playbooks are bundled when published.
Fixed
- Fixed resolving package root for test execution by supporting scoped package naming during path discovery.
[1.3.0] - 2026-06-25
Added
- Release management guidelines under
release/ (RELEASE_CHECKLIST.md, VERSIONING.md, PUBLISH_NPM.md, MIGRATION_GUIDE.md, CHANGELOG_TEMPLATE.md)
- Production-ready playbooks under
playbooks/:
playbooks/backend/ (API security, caching & messaging, resilience & observability)playbooks/system-design/ (Playbook template and Payment Processing & Notification examples)playbooks/database/ (Schema design, indexing, partitioning, transactions, migration, soft deletes, auditing)
- GitHub Actions CLI install smoke test that packs the npm artifact, runs
init through npx in a clean project, verifies generated files, and runs check
- README CI badge linking directly to the CLI install test
- Team adoption guide at docs/team-adoption-guide.md for structured onboarding and recurring workflow
- Claude Fable 5 support: updated CLAUDE.md and CLI templates with 1M context window guidance, extended session handoff, and long-running autonomous task patterns
docs/getting-started.md — first-steps guide with a 5-minute PUDO cycle, CLI install walkthrough, and mode selection guidancedocs/architecture.md — system diagrams, component breakdown, data flow, security boundaries, and repository layout rationaledocs/README.md — documentation index linking all docs with reading-order guidanceSUPPORT.md — community support channels, response time expectations, and guidance on asking good questions- Expanded
CONTRIBUTING.md with development setup, commit conventions, PR process, contribution types, and good-first-issue guidance
- Issue templates for documentation improvements and prompt submissions (
.github/ISSUE_TEMPLATE/)
- Expanded
docs/faq.md with team adoption, production incident, MCP server, and scope creep questions
Changed
- Updated templates in
src/cli.js to output release and quality rules
- Promoted the MCP server to the primary agent-facing product surface in the README, with its callable tools and security boundaries shown before the CLI documentation
- Updated the roadmap with packaged CLI verification and the path toward a publishable MCP server package
- Restructured
ROADMAP.md with short/mid/long-term lanes, status badges, and a narrative per milestone
- Upgraded
README.md with table of contents, architecture diagram, repository structure section, and fixed broken <iframe> sponsor embed
- Updated
SECURITY.md with explicit response SLA and escalation guidance for active exploits
[1.2.0] - 2026-06-10
Added
pudo check, pudo score, and pudo doctor executable workflow commands- Evidence-based
pudo score --json output and strict readiness enforcement with pudo score --strict
- PUDO MCP server alpha under packages/pudo-mcp-server with local stdio tools for init, validation, scoring, context packs, quality gates, diagnosis, and session handoff
- Agent tool and MCP security controls:
- Machine-readable schemas for score reports and MCP server policy in schemas/
- Repository ownership enforcement through .github/CODEOWNERS
- GitHub Action checker at .github/workflows/pudo-check.yml
- Context engineering guide at docs/context-engineering.md
- Agent skill contract at docs/agent-skill-contract.md
- Sample measured benchmark case under benchmarks/results/stripe-webhook-2026-05
- README onboarding paths for solo dev, team lead, and enterprise/security usage
Changed
- Repositioned PUDO as an AI Agent Operating Layer across Cursor, Claude, Codex, GitHub Copilot, and Gemini/Antigravity
- Expanded CLI generation support to Gemini, OpenCode, and Kiro
- Synchronized package and README badge version to
1.2.0
- Replaced file-existence scoring with content and evidence rubrics
[1.1.0] - 2026-05-23
Added
pudo init CLI scaffold via package.json and bin/pudo.js- Stack-specific templates in templates/ for Next.js, React Vite, Node Express, Python FastAPI, Django, Laravel, Go API, and React Native
- PUDO operating-kit state files in .pudo/ including config, session handoff, and release checklist
- GitHub workflow artifacts: pull request template and issue templates
- Benchmark kit in benchmarks/ with metrics sheet, calculator, task template, and before/after example
- New example 05-before-after-token-waste showing token and iteration reduction
- Governance and workflow docs:
Changed
- Repositioned README.md from a methodology + prompt library toward a developer operating kit
- Added install flow, PUDO modes, benchmark references, and operating-kit sections to the main README
- Added and aligned
Expected Impact claims across all README variants:
- Added
Quality Gates, current limitations, and updated AI integration guidance across localized READMEs
Integration Updates
Quality System
Notes
- The CLI is intentionally minimal and dependency-free at this stage.
- Benchmarks and expected impact numbers are directional until teams record their own measurements.