Skip to content

Releases: dcversus/prp

v0.4.1 - Complete Wiki.js Template Articles

28 Oct 17:54

Choose a tag to compare

🎉 Wiki.js Template Now Production-Ready!

All 13 stub articles in the Wiki.js template have been completed with comprehensive, fact-checked content. The template now generates fully-documented Wiki.js projects ready for immediate deployment.

✨ What's New

Complete Article Expansions (~6,894 lines added)

Core PRP Methodology (1,714 lines)

  • 📖 Article 10: PRP Overview - 267 lines (LOOP MODE workflow, flat structure)
  • 🎯 Article 11: Signal System - 598 lines (all 14 signals with reaction patterns)
  • 🧠 Article 12: Context-Driven Dev - 464 lines (context > commands philosophy)
  • 🤖 Article 13: Human as Agent - 385 lines (orchestrator autonomy protocol)

CLI Usage Guides (1,815 lines)

  • ⚙️ Article 20: CLI Installation - 590 lines (npm/npx/yarn/pnpm methods)
  • 💻 Article 21: CLI Usage - 653 lines (examples for all 6 templates)
  • 📦 Article 22: Templates - 572 lines (comprehensive template documentation)

Contributing & Administration (2,710 lines)

  • 🤝 Article 30: Contributing - 709 lines (with PRP LOOP MODE workflow)
  • 🏗️ Article 40: Wiki.js Basics - 456 lines (Docker setup, SSO, navigation)
  • ✏️ Article 41: Content Management - 710 lines (comprehensive editing guide)
  • ✅ Article 42: Best Practices - 835 lines (style guide, maintenance)

Research & Resources (445 lines)

  • 📚 Article 50: Research Papers - 231 lines (12 academic papers with DOI)
  • 🔗 Article 51: External Resources - 214 lines (67+ curated resources)

🎯 Quality Standards

✅ Every article has fact-check section with Tier 1 verified sources
✅ All code examples tested and validated
✅ All links verified as functional
✅ Content sourced from AGENTS.md, README.md, CONTRIBUTING.md
✅ All validation passing (typecheck ✓, lint ✓, 18/18 tests ✓)

📦 Installation

# Global installation
npm install -g @dcversus/prp@0.4.1

# Or use without installing
npx @dcversus/prp@0.4.1 --template wikijs

🚀 Try It Now

# Generate a complete Wiki.js documentation site
prp --name my-wiki --template wikijs --no-interactive

cd my-wiki

# Configure environment
cp .env.example .env

# Start Wiki.js with Docker
docker-compose up -d

# Access at http://localhost:3000

📊 Impact

  • 6,894 lines of comprehensive documentation added
  • 13 articles expanded from 12-17 line stubs to 228-835 lines each
  • 67+ resources curated across 8 categories
  • 12 academic papers cited with DOI links
  • 100% fact-checked with Tier 1 primary sources

🔗 Links

🙏 Acknowledgments

This release was completed using a parallel sub-agent strategy, with 8 specialized agents working autonomously to complete articles. Each agent sourced content from project documentation, tested all examples, and verified all sources.

Previous Versions:

  • v0.3.0 - Orchestrator Autonomy Protocol & Wiki.js template (beta)
  • v0.2.0 - PRP Methodology & Signal System
  • v0.1.0 - Initial release with basic templates

v0.3.0: Wiki.js Template & Orchestrator Autonomy

28 Oct 15:16

Choose a tag to compare

🚀 Release v0.3.0

Major Feature Release: Wiki.js template generator and Orchestrator Autonomy Protocol


✨ New Features

Wiki.js Template Generator

Complete documentation project scaffolding:

  • 🏗️ 20 pre-written articles covering PRP methodology, CLI usage, and Wiki.js administration
  • 🐳 Docker Compose setup with PostgreSQL, Redis, and Wiki.js
  • 🔐 Authentik SSO configuration template
  • 📚 Getting-started guides for non-developers
  • Article writing guidelines with fact-checking standards
  • 📝 GitHub registration guide
  • 🔑 Authentik login tutorial
  • 🤝 Contributing guidelines
  • ⚙️ Wiki.js administration basics

Orchestrator Autonomy Protocol

Revolutionary AI orchestration system (300+ lines in AGENTS.md):

  • 🤖 Rule 1: NO QUESTIONS TO HUMANS - Make autonomous decisions
  • 💬 Rule 2: ASYNC COMMUNICATION ONLY - Use ATTENTION signals in PRPs
  • 🚨 Rule 3: NUDGE FOR CRITICAL BLOCKS ONLY - Priority 10 scenarios
  • 🎯 Rule 4: AUTONOMOUS DECISION MAKING - Complete decision protocol
  • ⏱️ Timeout-based decisions (1h/4h/24h thresholds)
  • 🔄 Multi-PRP orchestration algorithms
  • 📊 Performance metrics and orchestrator mantras
  • 📖 Updated README.md with autonomous orchestration principles

PRP-009 Specification

  • 📋 Comprehensive tracking document for Wiki.js template
  • 📈 Detailed progress logs with autonomous decision rationale
  • 🔍 Technical implementation details
  • ⚠️ Risk assessment and mitigation strategies
  • 📝 Prioritized next steps and action items

🐛 Bug Fixes

  • CLI version: Updated hardcoded version from 0.1.0 to 0.2.0 in src/cli.ts:13
  • Non-interactive mode: Implemented missing non-interactive mode functionality
    • Created src/nonInteractive.ts with full project generation support
    • Added input validation for required options
    • Added proper error messages and exit codes
    • Supports all CLI flags: --no-git, --no-install, --license, etc.
  • E2E tests: Fixed all 5 failing E2E tests in install-upgrade.test.ts
    • Updated tests to use local build instead of npm package
    • Fixed tsconfig.json parsing test
    • Added CLI path verification in test setup
    • All 18 tests now passing
  • ESM compatibility: Fixed __dirname usage in ESM modules

📊 Release Statistics

  • Lines Added: ~2000 (documentation + code)
  • New Files: 2 (wikijs.ts, PRP-009.md)
  • Templates: 6 total (added wikijs)
  • Tests: 18/18 passing ✅
  • Build: Success ✅
  • Coverage: Unit + E2E tests

📦 Installation

# Global installation
npm install -g @dcversus/prp@0.3.0

# One-time usage
npx @dcversus/prp@0.3.0

# Verify version
prp --version  # Should output: 0.3.0

🎯 Usage Examples

Generate Wiki.js Project

npx @dcversus/prp
# Select "wikijs" template
# Follow prompts

Non-Interactive Mode

prp --name my-wiki --template wikijs --no-interactive

🔗 Links


⚠️ Breaking Changes

None - This is a backward-compatible minor version release.


🙏 Credits

Built with ❤️ by dcversus

Special thanks to all contributors and the PRP methodology community!


Full Changelog: v0.2.0...v0.3.0

v0.2.0 - PRP Methodology & Signal System

28 Oct 09:31

Choose a tag to compare

🚀 Major Release: PRP Methodology & Signal System

This release introduces a revolutionary context-driven development workflow that transforms PRP from a simple project scaffolding tool into a comprehensive methodology for AI-guided software development.

🎯 Highlights

  • PRP Methodology: Context-driven development using Product Requirement Prompts as living documents
  • Signal System: 14 emotional/state indicators enabling intelligent work prioritization
  • LOOP MODE: Continuous agent iteration guided by signals until DoD or checkpoint
  • Flat Structure: All PRPs now follow outcome-focused naming convention

✨ What's New

PRP Methodology & Signal System:

  • Signal System: 14 emotional/state indicators (ATTENTION, BLOCKED, TIRED, ENCANTADO, etc.)
  • Signal Strength: Priority system (1-10 scale) for intelligent work prioritization
  • Progress Log: Standardized table format tracking role, datetime, comment, signal
  • Agent Personalities: System Analyst with Portuguese flair, pragmatic Developer, skeptical Tester
  • Signal Reaction Patterns: Detailed action steps for each signal type
  • PRP LOOP MODE: Continuous iteration guided by signals until DoD or checkpoint
  • Mandatory PRP Workflow: Find/create PRP before any work (Policy #0)
  • TUI Selection: Interactive PRP selection when multiple exist
  • CLI Flags: `--file` and `--new` for PRP management

CI/CD Infrastructure:

  • Parallel CI jobs (lint, typecheck, test, security, build) for faster feedback
  • CHANGELOG.md check workflow (enforces mandatory updates on PRs)
  • Claude Code Review workflow (automated AI code review)
  • Quality gate job (requires all checks to pass)

Pre-commit Hooks:

  • Husky for git hook management
  • lint-staged for incremental linting and formatting
  • TypeScript type checking on pre-commit

Testing Infrastructure:

  • Unit tests for validation utilities (9 tests passing)
  • Jest configuration fixed (`coverageThreshold` typo corrected)
  • Test directory structure (`tests/unit/`, `tests/integration/`)

GitHub Templates:

  • Pull Request template with DOD checklist and CHANGELOG reminder
  • Bug report issue template
  • Feature request issue template
  • Template request issue template

Development Tools:

  • `.editorconfig` for consistent code formatting across editors
  • Updated `lint-staged` configuration in package.json

Documentation:

  • AGENTS.md with comprehensive PRP workflow and signal system
  • AGENTS.md with mandatory CHANGELOG policy
  • README.md updated with PRP methodology as main project goal
  • PRP-007 specification document for signal system
  • CLAUDE.md updated with AGENTS.md reference

🔄 Breaking Changes

PRP Directory Structure:

  • All PRPs now in flat structure (no subdirectories allowed)
  • Naming convention: `PRP-XXX-what-will-change.md` (2-4 words, kebab-case)
  • Renamed: `PRP-CLI.md` → `PRP-001-bootstrap-cli-created.md`
  • Renamed: `PRP-002-Landing-Page.md` → `PRP-002-landing-page-deployed.md`
  • Renamed: `PRP-007-signal-system.md` → `PRP-007-signal-system-implemented.md`
  • Consolidated PRP-002 supporting files into single document
  • Moved PRP-003 from research/ subdirectory to flat structure
  • Removed research/ subdirectory entirely

🐛 Bug Fixes

  • Jest configuration warning (`coverageThresholds` → `coverageThreshold`)

📦 Installation

```bash
npm install -g @dcversus/prp@0.2.0
```

🔗 Links


Signal: COMPLETED 🏁 (1)
Role: Release Manager (Claude Sonnet 4.5)
Comment: v0.2.0 successfully released with PRP methodology, signal system, CI/CD infrastructure, and flat structure enforcement. All tests passing (9/9), published to npm, GitHub release created. Major milestone achieved! 🎉