TradingAgents/.tasks/QUICKSTART.md

🚀 Scopecraft Quick Start Guide

Welcome to Scopecraft ! This guide will help you get started with the new workflow-based task system.

📋 Workflow States

Tasks move through three workflow states:

1. 📥 Backlog: Future work not yet started
2. 🔄 Current: Active work in progress
3. ✅ Archive: Completed work

🎯 Basic Commands

Creating Tasks

# Create a new task (goes to backlog by default)
sc task create --title "Add user authentication" --type feature --area auth

# Create and start immediately (goes to current)
sc task create --title "Fix login bug" --type bug --area auth --current

# Create from a template
sc task create --template feature --title "New Feature" --area ui

Working with Tasks

# Start working on a task (move to current)
sc task start implement-oauth-0127-AB

# Complete a task (move to archive)
sc task complete implement-oauth-0127-AB

# View a task
sc task get implement-oauth-0127-AB

# Update task metadata
sc task update implement-oauth-0127-AB --status "🔴 Blocked"

# Update a specific section
sc task update-section implement-oauth-0127-AB instruction "New instructions here"

Listing Tasks

# List current tasks (default)
sc task list

# List backlog tasks
sc task list --workflow backlog

# List all tasks including archived
sc task list --all

# Filter by type, status, or area
sc task list --type bug --status "🔵 In Progress"

📁 Task Structure

Each task is a .task.md file with:

1. Frontmatter: Type, status, area, and custom fields
2. Sections:
   • Instruction: What needs to be done
   • Tasks: Checklist of subtasks
   • Deliverable: Work outputs
   • Log: Execution history

🔧 Complex Tasks

For large tasks, create a folder with subtasks:

# Create a complex task
sc task create --title "Dashboard Redesign" --complex

# Add subtasks (numbered for sequencing)
sc task add-subtask dashboard-redesign "01-user-research"
sc task add-subtask dashboard-redesign "02-implement-ui"
sc task add-subtask dashboard-redesign "03-test-implementation"

💡 Tips

1. Keep current small: Only tasks actively being worked on
2. Review backlog regularly: Prioritize and prune
3. Archive monthly: Tasks are auto-organized by YYYY-MM
4. Use templates: Ensure consistency across similar tasks
5. Update logs: Document progress in the Log section

🔗 Task References

Reference other tasks using: @task:implement-oauth-0127-AB Reference specific sections: @task:implement-oauth-0127-AB#deliverable

---

For more information, visit the Scopecraft documentation.