claude-orchestration 1.0.2 → 1.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-orchestration",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "CLI tool to scaffold Claude orchestration workflows into your project",
   "bin": {
     "claude-orchestration": "bin/cli.js"

package/templates/claude/orchestration.md

@@ -25,6 +25,7 @@ If React indicators are present → use `workflows/react/` directory
 | `review.md` | Reviewing code for merge |
 | `pr.md` | Generating PR title and description |
 | `docs.md` | Writing or updating documentation |
+| `todo.md` | Creating and managing TODO lists for complex tasks |
 
 **Workflow Path:**
 - React projects: `workflows/react/{workflow}.md`
@@ -36,40 +37,5 @@ If React indicators are present → use `workflows/react/` directory
 - Skip workflows for trivial tasks (typos, simple renames, one-line fixes)
 - Workflows are process guidance, not rigid scripts
 - Read the workflow file before starting, adapt steps as needed
+- Use `todo.md` workflow for any task requiring 3+ distinct steps
 
----
-
-## React Architecture Rules
-
-All React workflows MUST follow these rules. Violations block merge.
-
-### Structure
-- **Feature-based**: Organize by feature, not by type
-- **No barrels**: NEVER use `index.ts` to re-export from a folder
-- **Entry naming**: Main file MUST match folder name (`Button/Button.tsx`, not `Button/index.tsx`)
-- **Colocation**: Keep related files together (component, hooks, types, tests, styles)
-
-### File Structure
-```
-features/
-  auth/
-    auth.tsx              # Entry point (matches folder name)
-    auth.hooks.ts         # Feature-specific hooks
-    auth.types.ts         # Feature-specific types
-    auth.test.tsx         # Feature tests
-    components/
-      LoginForm/
-        LoginForm.tsx     # Component entry (matches folder name)
-        LoginForm.test.tsx
-```
-
-### Import Convention
-```tsx
-// CORRECT: Direct imports
-import { LoginForm } from '@/features/auth/components/LoginForm/LoginForm'
-import { useAuth } from '@/features/auth/auth.hooks'
-
-// WRONG: Barrel imports - NEVER do this
-import { LoginForm } from '@/features/auth/components'
-import { useAuth } from '@/features/auth'
-```

package/templates/claude/workflows/react/feature.md

@@ -29,15 +29,12 @@ MUST answer:
 **Components:**
 - Function components only
 - `useState`/`useReducer` for local state
-- `useTransition` for non-urgent updates
-- `useDeferredValue` for expensive computations
-- `Suspense` for lazy-loaded components
 
 **Hooks:**
 - Extract reusable logic into custom hooks
 - Components handle rendering; hooks handle logic
 - Name descriptively: `useAuthState`, `useFormValidation`
-- Place in `{feature}.hooks.ts`
+- Place in `hooks/{feature}/{hookName}.ts`
 
 **State:**
 - Lift state only as high as necessary

package/templates/claude/workflows/todo.md

@@ -0,0 +1,19 @@
+# TODO Workflow
+
+> Use for tasks with 3+ steps requiring tracking
+
+## Process
+
+1. **Analyze**: Read codebase, identify steps, estimate complexity
+2. **Create**: One actionable TODO per distinct step, prioritize by dependencies
+3. **Execute**: ONE item `in_progress` at a time, update status immediately
+4. **Manage**: Add/cancel items as needed, break down complex items
+
+## Rules
+
+- Use only for complex tasks (3+ steps)
+- Single `in_progress` item maximum
+- Real-time status updates
+- Brief, actionable descriptions
+- Complete current before starting next
+- Save TODO files in project root as `{sensibleName}_TODO.md`