task-o-matic 0.0.13 → 0.0.14

package/docs/agents/cli.md

@@ -1,191 +1,100 @@
-# Task-O-Matic CLI Agent Guide
+# Task-O-Matic Agent Guide
 
-You are an AI agent with access to the Task-O-Matic CLI tool for managing development tasks. This guide provides comprehensive usage patterns and command reference for autonomous development workflows.
+Concise reference for AI agents using Task-O-Matic in autonomous workflows.
 
-## Core Commands Reference
+## Core Workflow Commands
 
 ### Task Management
-```bash
-# Get next task to work on (prioritizes subtasks over parent tasks)
-task-o-matic tasks get-next [--status todo] [--tag <tag>] [--effort <small|medium|large>]
-
-# Show detailed task information  
-task-o-matic tasks show --id <task-id>
-
-# Update task status
-task-o-matic tasks status --id <task-id> --status <todo|in-progress|completed>
-
-# List all tasks with optional filtering
-task-o-matic tasks list [--status <status>] [--tag <tag>]
-
-# Create new tasks
-task-o-matic tasks create --title "Task Title" [--content "Description"] [--effort <small|medium|large>] [--parent-id <id>] [--ai-enhance] [--stream]
-
-# Split tasks into subtasks using AI
-task-o-matic tasks split --task-id <id> [--tools] [--stream] [--ai-provider <provider>]
-
-# Update task details
-task-o-matic tasks update --id <task-id> [--title "New Title"] [--description "New Description"] [--status <status>] [--effort <effort>]
-
-# Delete tasks
-task-o-matic tasks delete --id <task-id> --force [--cascade]
-```
-
-### Planning & Documentation
-```bash
-# Generate AI implementation plans for tasks
-task-o-matic tasks plan --id <task-id> [--stream] [--ai-provider <provider>]
-
-# View existing implementation plans
-task-o-matic tasks get-plan --id <task-id>
-
-# Set manual implementation plan
-task-o-matic tasks set-plan --id <task-id> --plan "Plan text" [or --plan-file <path>]
-
-# Generate AI task documentation with project context
-task-o-matic tasks document --task-id <task-id> [--force] [--stream] [--ai-provider <provider>]
-
-# Get existing task documentation
-task-o-matic tasks get-documentation --id <task-id>
 
-# Add documentation from external file
-task-o-matic tasks add-documentation --id <task-id> --doc-file <path> [--overwrite]
-```
-
-### PRD Management
 ```bash
-# Parse PRD into structured tasks
-task-o-matic prd parse --file <prd-file> [--tools] [--stream] [--ai-provider <provider>]
+# List tasks (filter by status or tag)
+task-o-matic tasks list [-s <status>] [-t <tag>]
 
-# Improve PRD based on feedback
-task-o-matic prd rework --file <prd-file> --feedback "Feedback text" [--tools] [--output <output-file>] [--stream]
-```
+# Get next task to work on (prioritizes subtasks)
+task-o-matic tasks get-next [-s <status>] [-t <tag>]
 
-### Project Initialization
-```bash
-# Initialize task-o-matic in current directory
-task-o-matic init init
+# Update task status
+task-o-matic tasks status -i <task-id> -s <todo|in-progress|completed>
 
-# Configure AI providers
-task-o-matic config set --provider <openai|anthropic|openrouter> --model <model-name> [--api-key <key>]
+# Add documentation from file
+task-o-matic tasks add-documentation -i <task-id> --doc-file <path>
 ```
 
-## Autonomous Development Workflow
+## Typical Agent Workflow
 
-### Primary Work Loop
 ```bash
-# 1. Get next available task (subtasks have priority)
-TASK_ID=$(task-o-matic tasks get-next --status todo | grep -oE '[a-f0-9-]{36}')
-
-# 2. Show task details and mark as in-progress
-task-o-matic tasks show --id $TASK_ID
-task-o-matic tasks status --id $TASK_ID --status in-progress
-
-# 3. Generate implementation plan with project context
-task-o-matic tasks plan --id $TASK_ID --stream
-
-# 4. Check for existing documentation or create it
-task-o-matic tasks get-documentation --id $TASK_ID || \
-task-o-matic tasks document --task-id $TASK_ID --stream
+# 1. Get next task
+TASK=$(task-o-matic tasks get-next -s todo)
 
-# 5. Execute implementation (use your development tools)
-# - Read project files using filesystem access
-# - Implement code changes
-# - Add tests if needed
+# 2. Mark as in-progress
+task-o-matic tasks status -i $TASK_ID -s in-progress
 
-# 6. Validate implementation
-npm run check-types    # Fix any type errors
-npm run build         # Fix any build errors  
-npm test             # Fix any test failures
+# 3. Implement the task
+# (use your development tools)
 
-# 7. Commit changes with descriptive message
-git add .
-git commit -m "$(task-o-matic tasks show --id $TASK_ID | grep Title | cut -d: -f2-) - completed"
+# 4. Validate
+npm run check-types && npm run build && npm test
 
-# 8. Mark task as completed
-task-o-matic tasks status --id $TASK_ID --status completed
+# 5. Mark as completed
+task-o-matic tasks status -i $TASK_ID -s completed
 
-# 9. Repeat - get next task
-task-o-matic tasks get-next
+# 6. Repeat
 ```
 
-## Advanced Features
+## Bootstrap Options
 
-### AI-Enhanced Operations
-Use `--tools` flag to enable filesystem tools for AI operations:
+### Web Projects
 ```bash
-# Parse PRD with project context awareness
-task-o-matic prd parse --file prd.md --tools --stream
-
-# Split tasks with understanding of current codebase
-task-o-matic tasks split --task-id <id> --tools --stream
-
-# Rework PRD considering current implementation
-task-o-matic prd rework --file prd.md --feedback "Add auth" --tools --stream
+task-o-matic init init --project-name my-app --frontend next --backend hono
 ```
 
-### Getting Help
+### Multi-Frontend Monorepo
 ```bash
-# Get help for main commands
-task-o-matic --help
+# Web + Native + CLI + TUI
+task-o-matic init init --project-name my-app --frontend "next native-uniwind cli tui" --backend hono
 
-# Get help for specific command groups
-task-o-matic tasks --help
-task-o-matic prd --help
-task-o-matic config --help
+# Web + Native
+task-o-matic init init --project-name my-app --frontend "next native-bare" --backend hono
 
-# Get help for specific commands
-task-o-matic tasks create --help
-task-o-matic tasks split --help
+# Web + CLI
+task-o-matic init init --project-name my-app --frontend "next cli" --backend hono
 ```
 
-### AI Provider Configuration
+### Single Frontend Projects
 ```bash
-# Configure different AI providers
-task-o-matic config set --provider openai --model gpt-4 --api-key <your-key>
-task-o-matic config set --provider anthropic --model claude-3-sonnet-20240229 --api-key <your-key>
-task-o-matic config set --provider openrouter --model anthropic/claude-3.5-sonnet --api-key <your-key>
+# CLI only
+task-o-matic init init --project-name my-cli --frontend cli --cli-deps full
 
-# Use different providers per command
-task-o-matic tasks plan --id <task-id> --ai-provider anthropic --ai-model claude-3-sonnet-20240229
-```
+# TUI only
+task-o-matic init init --project-name my-tui --frontend tui --tui-framework solid
 
-## Best Practices for AI Agents
+# Native only
+task-o-matic init init --project-name my-mobile --frontend native-uniwind --backend hono
+```
 
-### Task Prioritization
-1. **Always work on subtasks first** - `get-next` automatically prioritizes them
-2. **Mark parent tasks as in-progress** when starting their subtasks
-3. **Complete subtasks before marking parent as complete**
+### Frontend Options
+- **Web**: next, tanstack-router, react-router, nuxt, svelte, solid
+- **Native**: native-bare, native-uniwind, native-unistyles
+- **Custom**: cli, tui
 
-### Quality Assurance
-1. **Always validate before completion**: type-check → build → test → commit
-2. **Use streaming output** (`--stream`) to monitor AI operations in real-time
-3. **Enable filesystem tools** (`--tools`) when context awareness is beneficial
+### CLI Dependency Levels
+- **minimal**: commander + chalk only
+- **standard**: + inquirer + dotenv (default)
+- **full**: + mocha + tsx (testing)
+- **task-o-matic**: + AI SDK (Vercel AI)
 
-### Error Recovery
-- **Type errors**: Fix immediately, re-run `npm run check-types`
-- **Build errors**: Fix immediately, re-run `npm run build`  
-- **Test failures**: Fix immediately, re-run `npm test`
-- **Task confusion**: Use `task-o-matic tasks show --id <id>` for clarification
+### TUI Framework Options
+- **solid**: Solid.js (default, recommended)
+- **vue**: Vue.js
+- **react**: React
 
-### Continuous Development
-- **Never stop the loop**: Immediately get next task after completing current one
-- **Maintain clean git history**: One commit per completed task
-- **Use descriptive commit messages**: Include task title and completion status
-- **Leverage AI enhancements**: Use `--ai-enhance`, `--tools`, and `--stream` flags appropriately
+## Getting Help
 
-## Command Discovery
-When you need to discover available commands or options:
+All commands support `--help`:
 ```bash
-# Explore available commands
 task-o-matic --help
-
-# Explore command groups  
 task-o-matic tasks --help
-task-o-matic prd --help
-
-# Get detailed help for specific commands
-task-o-matic tasks [command] --help
+task-o-matic tasks list --help
 ```
 
-This comprehensive reference enables autonomous AI agents to effectively use Task-O-Matic CLI for continuous development workflows with proper task management, planning, documentation, and quality assurance.
+Full command reference: `docs/task-o-matic_help.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "task-o-matic",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "description": "AI-powered task management CLI",
   "keywords": [
     "task-management",