Transmute

AI-powered PRD & task management system

Transform AI-generated PRDs into beautiful, trackable tasks

Features • Quick Start • For AI Agents • Tech Stack • Roadmap

---

✨ Features

• 🤖 AI-First Design - Structured markdown format optimized for AI agents to generate PRDs and tasks
• 📋 PRD Management - Beautiful rendering of Product Requirements Documents with status tracking
• ✅ Task Tracking - Hierarchical tasks with subtasks, priorities, and status filters
• 🎨 Premium UI - Dark theme with glassmorphism effects, smooth animations, and responsive design
• 📊 Dashboard - Overview of all projects with progress stats and metrics
• 🔄 Real-time Updates - Hot reload when markdown files change during development

📸 Screenshots

Dashboard with project overview and stats

Project detail with PRD and expandable tasks

🚀 Quick Start

Prerequisites

• Node.js 18+
• pnpm (recommended) or npm

Installation

# Clone the repository
git clone https://github.com/1001Josias/transmute.git
cd transmute

# Install dependencies
pnpm install

# Start development server
pnpm dev

Open http://localhost:3000 to see the app.

Creating Your First Project

1. Create a new directory in projects/:

   mkdir -p projects/my-project

2. Create prd.md with your PRD:

   ---
   id: "my-project"
   title: "My Awesome Project"
   status: "draft"
   version: "1.0"
   created_at: "2026-01-05"
   updated_at: "2026-01-05"
   author: "ai-agent"
   ---
   
   # My Awesome Project
   
   ## Objetivo
   
   Description of what this project aims to achieve...

3. Create tasks.md with your tasks:

   ---
   project_id: "my-project"
   prd_version: "1.0"
   created_at: "2026-01-05"
   updated_at: "2026-01-05"
   ---
   
   # Tasks: My Awesome Project
   
   ## Task 1: First Task
   
   - **id:** task-001
   - **status:** todo
   - **priority:** high
   - **description:** Description of the task.
   
   ### Subtasks
   
   #### [ ] First subtask
   
   Description of what needs to be done.

4. Refresh the browser to see your project!

🤖 For AI Agents

Transmute is designed to work seamlessly with AI coding assistants. See AGENTS.md for:

• Setup commands and code style
• PRD and Tasks markdown schemas
• Git conventions and PR instructions

Quick Reference

Field	PRD Values	Task Values
Status	draft, in_review, approved, rejected	todo, in_progress, done, blocked
Priority	-	low, medium, high, critical

📁 Project Structure

transmute/
├── apps/
│   ├── web/                   # Next.js App Router (Main App)
│   └── docs/                  # Fumadocs Documentation Site
├── packages/
│   ├── ui/                    # Shared UI components
│   ├── schemas/               # Shared Zod schemas
│   ├── utils/                 # Shared utilities
│   ├── tsconfig/              # Shared TypeScript configs
│   └── eslint-config/         # Shared ESLint configs
├── content/
│   └── projects/              # User projects (PRDs & Tasks)
└── AGENTS.md                  # Instructions for AI agents

🛠️ Tech Stack

Category	Technology
Framework	Next.js 15 (App Router)
Language	TypeScript
Styling	Tailwind CSS
Markdown	gray-matter + remark
Validation	Zod
Package Manager	pnpm

🗺️ Roadmap

🗺️ Roadmap & Projects

Transmute is built by Transmute. We use our own system to manage our roadmap. Check out the defined projects below:

Core Definitions (New!)

• Workspaces & Access Control - The "House" concept for isolation.
• Task Dependencies - Blockers and prerequisites.
• External Agent API - allowing agents to work together.
• Advanced Task Schema - Types, sizing, acceptance criteria.
• Task Drag & Drop - Reordering tasks visually.

Upcoming Features

• UI Editing & Interactivity (v1.1) - Edit tasks without Markdown.
• Integrations (v1.2) - GitHub, Jira, Linear sync.
• Enterprise Core (v2.0) - Multi-user, DB, Real-time.
• AI & Automation - Smart estimates and generation.

---

Made with 💜 by Josias Junior