PRDwise community

Get the Templates

Sun, 03 May 2026 00:00:00 +0000

The prdwise repository contains all templates, setup scripts, and agent instructions you need to get started.

Repositories
(Git): https://codeberg.org/PRDwise/prdwise
(Mercurial): https://hg.sr.ht/~francisco_reyes/prdwise

Choose Your Setup Guide

New to prdwise or agentic development?

Follow the beginner setup guide
Includes Mercurial installation, complete walkthrough, and examples

Experienced user?

See the quick setup guide
Get started in minutes with essential commands and references

Adding to an existing project?

Learn how to onboard your project
Covers integration, VCS setup, and migration strategies

What’s new

Recent additions to the framework, each with its own guide:

Learning Mode

Sun, 03 May 2026 00:00:00 +0000

Learning mode shifts the agent from doing your work to teaching you how to do it. You stay in the driver’s seat; the agent asks questions, suggests directions, or reviews what you wrote. It is opt-in and intended only for new projects.

What it is

A configuration layer on top of the standard prdwise workflow. When enabled, the agent picks a coaching style based on your profile (technical or writing) and adjusts how it responds — questions instead of answers, hints instead of solutions, reviews instead of rewrites.

Task Prep Workflows

Sun, 03 May 2026 00:00:00 +0000

Three workflows sit between “task created” and “agent starts coding”: architect review, research, and the prep-task wrapper that runs them in order with a gate in between.

What they are

architect-task — reviews the task spec for soundness: dependencies, risks, ADR candidates, missing context. Stops the line when the spec itself is broken.
research-task — gathers patterns, files, symbols, and notes the implementer will need. No code, just findings folded back into the task details.
prep-task — runs architect first, then research, with a gate. If architect flags blockers, research does not run until the spec is fixed.

When to use them

The task is non-trivial and you want to catch spec problems before burning time.
The task touches code you do not know well — research surfaces the patterns to follow.
You want a single command that does both gated end-to-end: use prep-task.

When to skip them

The task is small and obvious.
You already know the patterns and the spec is tight.
You are mid-implementation — these run before code, not during.

How to invoke

Trigger phrases (per the project’s CLAUDE.md):

T CLI and Task Workflow

Sun, 03 May 2026 00:00:00 +0000

T is a small bash helper for moving around the task system: list active tasks, open details, edit, show state, archive, work the backlog. It is a convenience wrapper — the canonical workflow lives in agent-task-rules.md.

What it is

A shell script at scripts/T that wraps common task operations against tasks/index.md and tasks/details/<id>.md. Run T with no arguments or T h for the current command list; the script’s own help is the source of truth for available commands.

Architecture Decision Records

Sun, 03 May 2026 00:00:00 +0000

An ADR captures one architecture decision: the context, the choice, the alternatives, and the consequences. prdwise treats ADRs as opt-in — you turn them on per project, and you can backfill them retroactively for existing work.

What it is

A short markdown file per decision, stored in your project. The create-adr workflow walks the agent through drafting one. The retroactive variant lets you write ADRs after the fact for decisions that are already in the code.

First steps on writing

Sat, 17 Jan 2026 00:00:00 +0000

It is said that a journey of a thousand miles begins with a single step. This is my first step on my writing journey. Although I had done some writing in the past, this is the beginning of what I hope will be a more focused attempt.

Many, likely most, of my writing will be technical writing about using AI to create. The goal will be to create content for beginners to intermediate users of AI who are learning, or want to learn, how to use AI to on content production.

Welcome and what to expect

Thu, 15 Jan 2026 00:00:00 +0000

Welcome to the PRDwise community. In this site, and blog, I will be sharing articles, guides and insight into how to use AI to create. Whether you plan to write software, articles or use AI to track projects I hope to give you useful info that you can use to help you in your journey

What is PRDwise framework?

PRDwise is a framework for structured, task-based development. Instead of diving straight into code, you:

About PRDwise

Mon, 01 Jan 0001 00:00:00 +0000

Welcome to PRDwise

PRDwise is two things: an open-source framework that helps you work effectively with AI assistants, and a community where creators share workflows and learn from each other.

The Community

Creating with AI requires new ways of thinking. Our community exists to:

Share strategies for collaborating effectively with AI assistants
Discuss tools, frameworks, and processes that work in practice
Explore different approaches across creative disciplines
Support creators navigating this evolving landscape

The Framework

PRDwise is a structured approach to AI-assisted work. It uses specifications—PRDs, task files, and briefs—to give AI assistants the context they need to help you build software, plan projects, and create content.