Skip to content

wrm3/ai_project_template

AI Project Template

Multi-IDE Development Framework for AI-Powered Coding

One system. Multiple IDEs. Zero duplication.

License: MIT Version PRs Welcome

A comprehensive project template that works seamlessly across 5 AI-powered IDEs (Claude Code, Cursor, Windsurf, Roo-Code, Cline) plus template framework for unlimited future IDE support, enabling teams to collaborate regardless of IDE preference.


🎯 What Makes This Unique

The Problem

You love Claude Code's Skills and Agents. Your teammate prefers Cursor's rules-based approach. Your project planning system is stuck in one IDE or the other.

The Solution

fstrent_spec_tasks provides:

  • 100% cross-IDE compatibility - Same tasks, plans, and bugs in both IDEs
  • Zero duplication - One source of truth, two interfaces
  • Team-ready - Everyone uses their preferred IDE
  • Git-friendly - Standard markdown files, easy merging
  • Future-proof - Add more IDE support anytime

How It Works

┌──────────────────────────────────────────────────────┐
│        .fstrent_spec_tasks/ (Shared Data)           │
│  ├── PLAN.md        (Product Requirements)          │
│  ├── TASKS.md       (Master task list)              │
│  ├── BUGS.md        (Bug tracking)                  │
│  └── tasks/         (Individual tasks)              │
└──────────────────────────────────────────────────────┘
                           ▲
         ┌─────────────────┼──────────────────────────┐
         │      │      │         │       │       │    │
    ┌────▼───┐ ▼──┐ ┌─▼──┐ ┌────▼────┐ ▼────┐ ┌▼──┐ │
    │ Claude │Cur-│ │Wind│ │Roo-Code│Cline│ │.ide│ │
    │  Code  │sor│ │surf│ │        │     │ │temp│ │
    │.claude/│.cu-│ │.wi-│ │.roo-   │.cli-│ │late│ │
    │ skills/│rso-│ │nds-│ │code/   │ ne/ │ │    │ │
    └────────┘r/  │ │urf/│ └────────┘     │ └────┘ │
              └───┘ └────┘                 └────────┘

         5 Fully Supported IDEs + Template for More

All IDEs read and write the same files. No conflicts. No translation. Just works.

🆕 agents.md Standard Support

This project now supports the industry-standard agents.md format (August 2025) for unified AI agent instructions:

  • One file for all IDEs - No more CLAUDE.md, cursor rules, Gemini.md, etc.
  • Adopted by 20+ companies - OpenAI, Cursor, Google Jules, Gemini CLI, Factory, Roo-Code
  • Backward compatible - Works with existing Claude Code and Cursor setups
  • Future-proof - New AI coding tools will support agents.md

See: agents.md for complete instructions
Learn more: https://agents.md


⚡ Quick Start

🎯 Choose Your Installation Method

NEW! This is now a Claude Code Marketplace with 8 plugin bundles. Choose what you need!


📦 Method 1: Claude Code Marketplace (Recommended)

Install only the bundles you need as Claude Code plugins:

Step 1: Add Marketplace

# In Claude Code
/plugin marketplace add wrm3/ai_project_template

Step 2: Install Plugin Bundles

Choose what you need:

# Core (everyone needs this)
/plugin install fstrent-spec-tasks@wrm3

# Startup founders
/plugin install fstrent-startup-toolkit@wrm3

# Oracle developers
/plugin install fstrent-oracle-toolkit@wrm3

# Teams using GitHub/Jira/Confluence
/plugin install fstrent-integration-toolkit@wrm3

# Researchers
/plugin install fstrent-research-toolkit@wrm3

# Document automation
/plugin install fstrent-document-toolkit@wrm3

# Web/browser automation
/plugin install fstrent-web-toolkit@wrm3

# Development agents (HIGHLY RECOMMENDED!)
/plugin install fstrent-developer-agents@wrm3

Step 3: Start Using

# Check what's available
/skills

# Create a task
/project:new-task Implement user authentication

# Check project status
/project:status

Pros:

  • ✅ Install only what you need
  • ✅ Works across all projects
  • ✅ Easy updates (reinstall to update)
  • ✅ Lighter memory footprint

Cons:

  • ❌ Requires internet
  • ❌ Global installation (not project-specific)

📁 Method 2: Project Template (For Teams & Customization)

Copy configuration to specific project for full customization:

For Claude Code Users

# Clone the repository
git clone https://github.com/wrm3/ai_project_template.git
cd ai_project_template

# Copy everything to your project
cp -r .claude your-project/
cp -r .cursor your-project/
cp -r .fstrent_spec_tasks your-project/
cp agents.md your-project/

# Open your project in Claude Code
# Skills are automatically available!

Try it:

/project:status

For Cursor Users

# Clone the repository
git clone https://github.com/wrm3/ai_project_template.git
cd ai_project_template

# Copy Cursor interface to your project
cp -r .cursor your-project/

# Open your project in Cursor
# Rules are automatically loaded!

Try it:

Ask Cursor's AI: "What's the current project status?"

For Windsurf Users

# Clone the repository
git clone https://github.com/wrm3/ai_project_template.git
cd ai_project_template

# Copy Windsurf interface to your project
cp -r .windsurf your-project/

# Open your project in Windsurf
# Rules are automatically loaded!

Try it:

/windsurf:status

For Roo-Code Users

# Clone the repository
git clone https://github.com/wrm3/ai_project_template.git
cd ai_project_template

# Copy Roo-Code interface to your project
cp -r .roo-code your-project/

# Open your project in Roo-Code
# Rules are automatically loaded!

Try it:

/status

For Cline Users (VS Code Extension)

# Clone the repository
git clone https://github.com/wrm3/ai_project_template.git
cd ai_project_template

# Copy Cline interface to your project
cp -r .cline your-project/

# Open your project in VS Code with Cline extension
# Start chatting!

Try it:

Show me the project status

For All IDEs (Recommended for Teams)

# Copy all interfaces + agents.md standard
cp -r .claude your-project/
cp -r .claude-plugin your-project/
cp -r .cursor your-project/
cp -r .windsurf your-project/
cp -r .roo-code your-project/
cp -r .cline your-project/
cp agents.md your-project/
cp CLAUDE.md your-project/  # References agents.md for compatibility

# Now anyone can use any of the 5 supported IDEs!

agents.md Standard (Works with All Tools)

# Just copy agents.md to your project
cp agents.md your-project/

# This one file works with:
# - OpenAI Codex
# - Cursor
# - Google Jules
# - Gemini CLI
# - Factory
# - Roo-Code
# - And more!

Your First Task

In Claude Code:

/new-task Implement user authentication

In Cursor:

@Cursor create a new task for implementing user authentication

In Windsurf:

/new-task Implement user authentication

In Roo-Code:

/new-task Implement user authentication

In Cline:

Create a new task for implementing user authentication

Result: Task file created in .fstrent_spec_tasks/tasks/, visible in ALL 5 IDEs!


🎁 Plugin Bundles

1. fstrent-spec-tasks (Core - Start Here!)

Task management, project planning, and QA

  • 4 skills: task management, planning, QA, code review
  • 1 agent: task-expander
  • 7 commands: /new-task, /status, /report-bug, etc.

Best for: All developers

2. fstrent-startup-toolkit

Complete toolkit for startup founders

  • 5 skills: VC fundraising, business formation, product development, resource access, patent filing
  • 2 agents: fundraising specialist, patent specialist

Best for: Startup founders, entrepreneurs

3. fstrent-oracle-toolkit

Oracle APEX and database development

  • 2 skills: Oracle APEX, database tools
  • 1 agent: Oracle APEX specialist

Best for: Oracle developers, DBAs

4. fstrent-integration-toolkit

External system integrations

  • 3 skills: GitHub, Atlassian (Jira/Confluence), MediaWiki

Best for: Teams using these platforms

5. fstrent-research-toolkit

Research and knowledge management

  • 5 skills: deep research, research methodology, YouTube analysis, RAG storage, knowledge base
  • 1 agent: YouTube researcher

Best for: Researchers, content creators

6. fstrent-document-toolkit

Office document automation

  • 4 skills: Excel (XLSX), Word (DOCX), PowerPoint (PPTX), PDF

Best for: Business analysts, report automation

7. fstrent-web-toolkit

Web and desktop automation

  • 2 skills: web tools, computer use agent

Best for: QA engineers, automation specialists

8. fstrent-developer-agents ⭐ (Highly Recommended!)

15 specialized development agents

  • Development: backend, frontend, full-stack, database
  • Quality: test-runner, code-reviewer, debugger, QA engineer
  • Security/DevOps: security auditor, DevOps engineer, Docker specialist
  • Docs/Architecture: technical writer, solution architect, API designer

Best for: All developers (60-80% context reduction, 10x productivity!)


🚀 Features

Task Management

  • ✅ Create, update, and track tasks
  • ✅ Task status management (Pending, In Progress, Completed)
  • ✅ Priority levels (Critical, High, Medium, Low)
  • ✅ Task dependencies and sub-tasks
  • ✅ Automatic task expansion for complex work

Project Planning

  • ✅ Product Requirements Documents (PRD)
  • ✅ Feature specifications
  • ✅ User stories and acceptance criteria
  • ✅ Project context and scope management
  • ✅ 27-question planning framework

Bug Tracking

  • ✅ Centralized bug tracking
  • ✅ Severity classification
  • ✅ Bug-to-task relationships
  • ✅ Resolution tracking
  • ✅ Quality metrics

Cross-IDE Compatibility

  • ✅ Works in Claude Code, Cursor, Windsurf, and more
  • ✅ Same data, different interfaces
  • ✅ No file conflicts
  • ✅ Git-based collaboration
  • ✅ Seamless IDE switching

Team Collaboration

  • ✅ Mixed IDE teams supported
  • ✅ Git-friendly file formats
  • ✅ Clear merge conflict resolution
  • ✅ Shared vocabulary and processes
  • ✅ Coordinated workflows

📦 What's Included

For Claude Code

Skills (.claude/skills/):

  • fstrent-task-management - Complete task lifecycle management
  • fstrent-planning - Project planning and PRD creation
  • fstrent-qa - Bug tracking and quality assurance

Agents (.claude/agents/) - 15 Specialized SubAgents:

  • Development: backend-developer, frontend-developer, full-stack-developer, database-expert
  • Quality: test-runner (proactive), code-reviewer, debugger, qa-engineer
  • Security/DevOps: security-auditor (opus), devops-engineer, docker-specialist
  • Documentation: technical-writer, solution-architect (opus), api-designer
  • Workflow: task-expander (proactive)

🆕 SubAgents System - 10x productivity through parallel processing and 60-80% context reduction!

Commands (.claude/commands/):

  • /project:new-task - Create a new task
  • /project:update-task - Update task status
  • /project:report-bug - Report a bug
  • /project:start-planning - Initialize project planning
  • /project:add-feature - Add a feature document
  • /project:quality-report - Generate quality metrics
  • /project:status - Get project overview

For Cursor

Rules (.cursor/rules/fstrent_spec_tasks/):

  • Core task management rules
  • Planning system rules
  • QA and bug tracking rules
  • Workflow management rules

Commands:

  • /fstrent_spec_tasks_setup - Initialize system
  • /fstrent_spec_tasks_plan - Activate planning
  • /fstrent_spec_tasks_qa - Activate QA
  • /fstrent_spec_tasks_workflow - Activate workflow management

Shared Data (.fstrent_spec_tasks/)

Core Files:

  • PLAN.md - Product Requirements Document
  • TASKS.md - Master task checklist
  • BUGS.md - Bug tracking
  • PROJECT_CONTEXT.md - Project mission and goals
  • SUBSYSTEMS.md - Component registry
  • FILE_REGISTRY.md - File documentation
  • MCP_TOOLS_INVENTORY.md - Available tools

Directories:

  • tasks/ - Individual task files
  • features/ - Feature specifications

📚 Documentation

Getting Started

Examples

Reference


💡 Use Cases

Solo Developer

Scenario: You work on multiple projects and want consistent task management.

Solution: Install in all projects. Switch between IDEs based on task type. All your planning stays consistent.

Benefits:

  • Consistent workflow across projects
  • Learn new IDE without abandoning your system
  • Future-proof your workflow

Small Team (2-10 People)

Scenario: Your team uses different IDEs but needs to coordinate work.

Solution: Everyone installs their preferred interface. All work tracked in shared .fstrent_spec_tasks/ files.

Benefits:

  • No IDE conflicts
  • Everyone sees the same tasks
  • Git-based collaboration works perfectly

Mixed IDE Team

Scenario: Half your team uses Cursor, half uses Claude Code.

Solution: Commit both interfaces to Git. Everyone clones and uses their preferred IDE.

Benefits:

  • Zero friction for team members
  • No "translation" between systems
  • Seamless code reviews

Learning & Teaching

Scenario: Teaching students or onboarding new developers.

Solution: Use example project as learning resource. Students can use either IDE.

Benefits:

  • Lower barrier to entry
  • Students choose comfortable IDE
  • Focus on concepts, not tools

🎓 Example Project

We've included a complete working example to help you get started:

TaskFlow - A simple task management web app built with Flask

cd example-project
pip install -r requirements.txt
python src/app.py
# Open http://localhost:5000

What's Included:

  • ✅ Complete PRD (4,800 words)
  • ✅ 16 sample tasks (various states)
  • ✅ 4 sample bugs
  • ✅ 3 feature specifications
  • ✅ Working Flask application (200 lines)
  • ✅ Both IDE interfaces configured
  • ✅ Comprehensive README

Learn From:

  • How to structure a PRD
  • How to write effective tasks
  • How to track bugs
  • How code relates to tasks
  • How both IDEs work together

Explore the Example →


🔧 Installation

Prerequisites

  • Git
  • Python 3.11+ (for example project)
  • Either Cursor or Claude Code (or both!)

Option 1: Use Example as Template

# Clone this repository
git clone https://github.com/wrm3/ai_project_template.git

# Copy example to your project
cp -r ai_project_template/example-project my-project
cd my-project

# Customize for your project
# Edit .fstrent_spec_tasks/PROJECT_CONTEXT.md
# Edit .fstrent_spec_tasks/PLAN.md
# Start creating tasks!

Option 2: Add to Existing Project

# Navigate to your project
cd my-existing-project

# Copy interfaces
cp -r /path/to/ai_project_template/.claude .
cp -r /path/to/ai_project_template/.claude-plugin .
cp -r /path/to/ai_project_template/.cursor .

# Initialize task system
mkdir -p .fstrent_spec_tasks/tasks
mkdir -p .fstrent_spec_tasks/features

# Copy template files
cp /path/to/ai_project_template/example-project/.fstrent_spec_tasks/*.md .fstrent_spec_tasks/

# Customize for your project

Option 3: Install as Plugin (Claude Code)

# Coming soon!
# /plugin marketplace add your-username/ai_project_template
# /plugin install ai_project_template

🤝 Team Collaboration

Git Workflow

Step 1: Initial Setup

# Team lead sets up project
git init
# Copy both IDE interfaces
cp -r .claude .cursor .fstrent_spec_tasks my-project/
cd my-project
git add .
git commit -m "Add fstrent_spec_tasks system"
git push

Step 2: Team Members Clone

# Each team member clones
git clone <repository-url>
cd project

# Open in preferred IDE
# Cursor users: Open in Cursor
# Claude Code users: Open in Claude Code

Step 3: Daily Workflow

# Pull latest changes
git pull

# Create/update tasks in your IDE
# (Changes go to .fstrent_spec_tasks/)

# Commit and push
git add .fstrent_spec_tasks/
git commit -m "Update tasks"
git push

Step 4: Switching IDEs

# Just close one IDE and open the other
# All your tasks are there!

Handling Merge Conflicts

Common Conflict: TASKS.md

# Two people added tasks simultaneously
git pull
# CONFLICT in .fstrent_spec_tasks/TASKS.md

# Open TASKS.md, find:
<<<<<<< HEAD
- [ ] Task 042: Feature A
=======
- [ ] Task 042: Feature B
>>>>>>> origin/main

# Resolve by merging both:
- [ ] Task 042: Feature A
- [ ] Task 043: Feature B

# Commit resolution
git add .fstrent_spec_tasks/TASKS.md
git commit -m "Resolve task list conflict"

See Full Collaboration Guide →


🎯 Comparison with Other Systems

Feature fstrent_spec_tasks Jira GitHub Issues Notion
Works in Multiple IDEs ✅ Cursor + Claude Code ❌ Web only ❌ Web/GitHub ❌ Web only
Offline Access ✅ Full ❌ Limited ❌ No ❌ Limited
Git-Friendly ✅ Markdown files ❌ Database ✅ Yes ❌ No
No Account Required ✅ Yes ❌ No ❌ No ❌ No
Free & Open Source ✅ Yes ❌ Paid ✅ Yes ❌ Freemium
AI Integration ✅ Native ❌ No ❌ Limited ❌ Limited
Team Collaboration ✅ Git-based ✅ Built-in ✅ Built-in ✅ Built-in
Customizable ✅ Fully ❌ Limited ❌ Limited ✅ Yes

Best For:

  • ✅ Developers who live in their IDE
  • ✅ Teams with mixed IDE preferences
  • ✅ Projects that need Git-based workflows
  • ✅ Teams that value simplicity and control

Not For:

  • ❌ Non-technical teams
  • ❌ Large enterprises needing complex workflows
  • ❌ Teams requiring real-time collaboration
  • ❌ Projects needing advanced reporting

🛠️ Advanced Features

🤖 SubAgents System (15 Specialized Agents)

Transform your development workflow with AI specialists for every task!

The SubAgents system provides 15 specialized AI agents that work in parallel, reducing context usage by 60-80% and accelerating development by 10x for complex features.

Development Agents

  • backend-developer - API development, microservices, database integration
  • frontend-developer - React, TypeScript, responsive UI
  • full-stack-developer - End-to-end features (inherits MCP tools)
  • database-expert - Schema design, query optimization, migrations

Quality & Testing

  • test-runner - Automatically runs tests after code changes (PROACTIVE)
  • code-reviewer - Comprehensive code reviews (quality, security, best practices)
  • debugger - Error diagnosis, stack trace analysis, performance profiling
  • qa-engineer - Test planning, manual testing, quality metrics

Security & DevOps

  • security-auditor - Vulnerability assessment, threat modeling (Opus model)
  • devops-engineer - CI/CD pipelines, infrastructure as code
  • docker-specialist - Container optimization, Docker Compose

Documentation & Architecture

  • technical-writer - API docs, README, code comments
  • solution-architect - System design, technology selection (Opus model)
  • api-designer - REST/GraphQL API design, versioning

Workflow

  • task-expander - Automatically breaks down complex tasks (PROACTIVE)

Example: Parallel Feature Development

You: "Build a complete blog feature"

Claude coordinates automatically:
  ├─ solution-architect: Designs architecture
  ├─ database-expert: Creates schema & migrations
  ├─ backend-developer: Builds REST API
  ├─ frontend-developer: Creates React components
  ├─ test-runner: Writes comprehensive tests
  ├─ security-auditor: Performs security review
  └─ technical-writer: Documents API endpoints

Result: Complete feature in 1/10th the time!

Learn More →

Planning Framework

27-question framework for comprehensive project planning:

Phase 1: Project Context (Q1-Q7)

  • Problem definition
  • Success criteria
  • User identification

Phase 2: Technical Requirements (Q8-Q16)

  • Deployment strategy
  • Security needs
  • Performance expectations

Phase 3: Feature Scope (Q17-Q22)

  • Essential features
  • Nice-to-haves
  • Features to avoid

Phase 4: Timeline & Resources (Q23-Q27)

  • Timeline drivers
  • Delivery preferences
  • Trade-offs

See Full Framework →

Quality Metrics

Track project health with built-in metrics:

  • Task Completion Rate: % of tasks completed on time
  • Bug Discovery Rate: Bugs found per development cycle
  • Bug Resolution Time: Average time to fix bugs
  • Feature Impact: Which features have most bugs
  • Velocity: Tasks completed per sprint

See All Metrics →


📊 Project Stats

Documentation: 47,500+ words

  • Setup guides: 12,400 words
  • Example project: 23,600 words
  • Troubleshooting: 11,500 words

Code: 200+ lines (example Flask app)

Files: 50+ files across all components

Skills: 3 Claude Code Skills with progressive disclosure

Commands: 7 Claude Code commands + 4 Cursor commands

SubAgents: 15 specialized AI agents covering full SDLC (Development, Quality, Security, DevOps, Documentation)


🤔 FAQ

Q: Can I use only one IDE?

A: Yes! Both interfaces are included, but you can use just one. The .fstrent_spec_tasks/ files work with either IDE.

Q: How do I switch between IDEs?

A: Just close one IDE and open the other in the same directory. All your tasks, plans, and bugs are there.

Q: What if my team uses different IDEs?

A: Perfect! That's exactly what this system is designed for. Commit both .cursor/ and .claude/ to Git. Everyone uses their preferred IDE.

Q: Do I need to install anything?

A: Just copy the interface files (.cursor/ or .claude/) to your project. No npm packages, no pip installs (except for the example Flask app).

Q: Can I customize the system?

A: Absolutely! All files are markdown and YAML. Edit templates, add custom fields, modify workflows. It's your system.

Q: What about merge conflicts?

A: Rare, but possible. Most conflicts are in TASKS.md and are easy to resolve. See the Compatibility Guide for details.

Q: Is this production-ready?

A: Yes! We use it daily for real projects. The example project demonstrates production-quality setup.

Q: How do I contribute?

A: We welcome contributions! See CONTRIBUTING.md for guidelines.


🗺️ Roadmap

v0.1.0 (Current)

  • ✅ Core task management
  • ✅ Project planning (PRD)
  • ✅ Bug tracking
  • ✅ Cross-IDE compatibility (Cursor + Claude Code)
  • ✅ Example project
  • ✅ Comprehensive documentation

v0.2.0 (Current)

  • Claude Code SubAgents System - 15 specialized AI agents
  • ✅ agents.md standard support
  • ⏳ Plugin marketplace distribution
  • ⏳ Additional IDE support (Windsurf, Roo-Code)
  • ⏳ Enhanced task templates
  • ⏳ Time tracking integration

v1.0.0 (Future)

  • ⏳ Web dashboard (optional)
  • ⏳ API for external integrations
  • ⏳ Advanced reporting
  • ⏳ Team analytics
  • ⏳ Mobile app (view-only)

See Full Roadmap →


🙏 Acknowledgments

Inspired By:

  • Cursor's innovative rules-based AI assistance
  • Claude Code's Skills and Agents architecture
  • The need for IDE-agnostic development tools

Built With:

  • Markdown for universal compatibility
  • YAML for structured data
  • Git for version control
  • Python for example application

Special Thanks:

  • The Cursor team for their amazing IDE
  • Anthropic for Claude Code and Claude AI
  • The open-source community

📄 License

MIT License - see LICENSE file for details.

TL;DR: Free to use, modify, and distribute. Just keep the license notice.


🚀 Get Started Now

# Clone the repository
git clone https://github.com/wrm3/ai_project_template.git

# Explore the example
cd ai_project_template/example-project
pip install -r requirements.txt
python src/app.py

# Copy to your project
cp -r .claude .cursor .fstrent_spec_tasks ../my-project/

# Start planning!

Questions? Check the documentation or open an issue.

Ready to collaborate across IDEs? Give it a try! ⭐


Made with ❤️ for developers who value flexibility

DocumentationExample ProjectIssuesDiscussions

About

template for projects that you plan on having one or more different AI Assistants working in, and attempting to keep co-ordinated

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors