@mindfoldhq/trellis 0.1.0 → 0.1.1

package/dist/templates/commands/index.js

@@ -22,8 +22,11 @@ function readCommand(subdir, filename) {
 // =============================================================================
 // Claude-specific commands
 export const claudeStartTemplate = readCommand("claude", "start.md.txt");
+export const claudeParallelTemplate = readCommand("claude", "parallel.md.txt");
 // Cursor-specific commands
 export const cursorStartTemplate = readCommand("cursor", "start.md.txt");
+// OpenCode-specific commands
+export const opencodeStartTemplate = readCommand("opencode", "start.md.txt");
 // =============================================================================
 // Common Templates (work with all AI tools)
 // =============================================================================
@@ -54,6 +57,12 @@ const ALL_TEMPLATES = [
         description: "Initialize AI agent with project context",
         category: "claude",
     },
+    {
+        name: "parallel",
+        content: claudeParallelTemplate,
+        description: "Multi-agent pipeline in isolated worktrees",
+        category: "claude",
+    },
     // Cursor-specific
     {
         name: "start",
@@ -61,6 +70,13 @@ const ALL_TEMPLATES = [
         description: "Initialize AI agent with project context",
         category: "cursor",
     },
+    // OpenCode-specific
+    {
+        name: "start",
+        content: opencodeStartTemplate,
+        description: "Initialize AI agent with project context",
+        category: "opencode",
+    },
     // Common
     {
         name: "record-agent-flow",

package/dist/templates/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/commands/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/commands/index.ts"],"names":[],"mappings":"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"}

package/dist/templates/commands/opencode/start.md.txt

@@ -0,0 +1,127 @@
+# Start Session
+
+Initialize your AI development session and begin working on tasks.
+
+## Initialization
+
+1. Get session context:
+   ```bash
+   ./.trellis/scripts/get-context.sh
+   ```
+
+2. Read `.trellis/structure/guides/index.md` for thinking guidelines
+
+3. Report ready status and ask for task
+
+---
+
+## Working on Tasks
+
+### For Simple Tasks
+
+1. Read relevant guidelines based on task type:
+   - Frontend: `.trellis/structure/frontend/`
+   - Backend: `.trellis/structure/backend/`
+
+2. Implement the task directly
+
+3. Before committing, remind user to run `/finish-work`
+
+### For Complex Tasks (Multi-Step Features)
+
+Use feature tracking and delegate to specialized agents for better quality.
+
+#### Step 1: Create Feature
+
+```bash
+./.trellis/scripts/feature.sh create <name>
+# Example: ./.trellis/scripts/feature.sh create user-auth
+```
+
+#### Step 2: Initialize Context
+
+```bash
+FEATURE_DIR=".trellis/agent-traces/{developer}/features/{feature-name}"
+./.trellis/scripts/feature.sh init-context "$FEATURE_DIR" <type>
+# type: backend | frontend | fullstack
+```
+
+#### Step 3: Add Task-Specific Guidelines
+
+Based on what the task involves, add relevant spec files:
+
+```bash
+# Example: adding database and API guidelines for a backend task
+./.trellis/scripts/feature.sh add-context "$FEATURE_DIR" implement ".trellis/structure/backend/database-guidelines.md"
+./.trellis/scripts/feature.sh add-context "$FEATURE_DIR" implement ".trellis/structure/backend/api-module.md"
+```
+
+Verify with:
+```bash
+./.trellis/scripts/feature.sh list-context "$FEATURE_DIR"
+```
+
+#### Step 4: Document Requirements
+
+Create `prd.md` in the feature directory describing what needs to be done.
+
+For complex tasks, also create `info.md` with technical approach.
+
+#### Step 5: Start Feature
+
+```bash
+./.trellis/scripts/feature.sh start "$FEATURE_DIR"
+```
+
+#### Step 6: Delegate Work
+
+Use specialized agents for implementation. In OpenCode, use the `@agent` syntax:
+
+```
+@implement Implement the feature described in prd.md
+```
+
+After implementation, verify quality:
+
+```
+@check Check code changes and fix any issues
+```
+
+#### Step 7: Complete
+
+1. Verify typecheck and lint pass
+2. Remind user to test
+3. Remind user to commit
+4. **Record session progress**: Ask user to run `/record-agent-flow`
+5. Archive feature (if fully completed):
+   ```bash
+   ./.trellis/scripts/feature.sh archive <feature-name>
+   ```
+
+---
+
+## Session End Reminder
+
+**IMPORTANT**: When a task or session is completed, always remind the user:
+
+> Before ending this session, please run `/record-agent-flow` to record what we accomplished.
+> This helps maintain continuity across sessions.
+
+---
+
+## Quick Reference
+
+| Task Size | Approach |
+|-----------|----------|
+| Small fix / simple change | Implement directly |
+| New feature / multi-file change | Use feature tracking + delegation |
+| Research / exploration | Use research agent |
+
+| Command | Purpose |
+|---------|---------|
+| `feature.sh create <name>` | Create feature directory |
+| `feature.sh start <dir>` | Set as current feature |
+| `feature.sh finish` | Clear current feature |
+| `feature.sh archive <name>` | Archive completed feature |
+| `feature.sh list` | List all features |
+| `/record-agent-flow` | **Record session progress (run at session end)** |

package/dist/templates/markdown/agent-traces-index.md.txt

@@ -1,12 +1,12 @@
-# Agent Progress Index
+# Agent Traces Index
 
-> Records of all AI Agent work sessions across all developers
+> Records of all AI Agent work traces across all developers
 
 ---
 
 ## Overview
 
-This directory tracks progress for all developers working with AI Agents on this project.
+This directory tracks traces for all developers working with AI Agents on this project.
 
 ### File Structure
 
@@ -18,7 +18,7 @@ agent-traces/
     |-- features/         # Feature files
     |   |-- *.json        # Active features
     |   \-- archive/      # Archived features by month
-    \-- progress-N.md     # Progress files (sequential: 1, 2, 3...)
+    \-- traces-N.md     # Progress files (sequential: 1, 2, 3...)
 ```
 
 ---
@@ -45,7 +45,7 @@ This will:
 1. Create your identity file (gitignored)
 2. Create your progress directory
 3. Create your personal index
-4. Create initial progress file
+4. Create initial traces file
 
 ### For Returning Developers
 
@@ -63,10 +63,10 @@ This will:
 
 ## Guidelines
 
-### Progress File Rules
+### Traces File Rules
 
-- **Max 2000 lines** per progress file
-- When limit is reached, create `progress-{N+1}.md`
+- **Max 2000 lines** per traces file
+- When limit is reached, create `traces-{N+1}.md`
 - Update your personal `index.md` when creating new files
 
 ### Session Record Format
@@ -121,4 +121,3 @@ Use this template when recording sessions:
 ---
 
 **Language**: All documentation must be written in **English**.
-

package/dist/templates/markdown/agents.md.txt

@@ -11,7 +11,7 @@ Use the `/start` command when starting a new session to:
 Use `@/.trellis/` to learn:
 - Development workflow (`workflow.md`)
 - Project structure guidelines (`structure/`)
-- Progress tracking (`agent-traces/`)
+- Session traces (`agent-traces/`)
 
 Keep this managed block so 'trellis update' can refresh the instructions.
 

package/dist/templates/markdown/init-agent.md.txt

@@ -21,7 +21,7 @@
 
 This creates:
 - `.trellis/.developer` - Your identity file (gitignored, not committed)
-- `.trellis/agent-traces/<your-name>/` - Your personal progress directory
+- `.trellis/agent-traces/<your-name>/` - Your personal traces directory
 
 **Naming suggestions**:
 - Human developers: Use your name, e.g., `john-doe`
@@ -116,12 +116,12 @@ your-project/
 │   │   ├── feature.sh       # Feature management
 │   │   ├── get-context.sh   # Get session context
 │   │   └── add-session.sh   # Record session
-│   ├── agent-traces/      # Work progress records
+│   ├── agent-traces/      # Work traces records
 │   │   └── {developer}/     # Per-developer directories
 │   │       ├── features/    # Feature directories
 │   │       │   └── {day}-{name}/
 │   │       │       └── feature.json
-│   │       └── progress-N.md
+│   │       └── traces-N.md
 │   ├── structure/           # [!] Development guidelines (MUST READ)
 │   │   ├── frontend/
 │   │   │   ├── index.md     # Frontend guidelines index
@@ -148,7 +148,7 @@ This project uses a structured workflow system based on [Anthropic's best practi
 |------|---------|----------------|
 | `.trellis/workflow.md` | Complete workflow guide | Read at session start |
 | `.trellis/agent-traces/{developer}/features/` | Feature tracking | When creating/completing features |
-| `.trellis/agent-traces/{developer}/progress-N.md` | Session work records | After each session |
+| `.trellis/agent-traces/{developer}/traces-N.md` | Session work records | After each session |
 
 ### Key Rules (CRITICAL - Must Follow)
 
@@ -158,9 +158,9 @@ This project uses a structured workflow system based on [Anthropic's best practi
    - This is **mandatory**, not optional
 
 **2. Document Limits** **CRITICAL RULE**
-   - `agent-traces/{developer}/progress-N.md` max 2000 lines
+   - `agent-traces/{developer}/traces-N.md` max 2000 lines
    - **IMPORTANT: Only create new file when current file EXCEEDS 2000 lines**
-   - File naming: Use sequential numbers (`progress-1.md`, `progress-2.md`...)
+   - File naming: Use sequential numbers (`traces-1.md`, `traces-2.md`...)
 
 **3. Update Tracking Files**
    - After completing work: Update `agent-traces` (include commit hashes)
@@ -214,7 +214,7 @@ This project uses a structured workflow system based on [Anthropic's best practi
 ```
 
 This automatically:
-- Appends session to current progress file
+- Appends session to current traces file
 - Creates new file if 2000-line limit exceeded
 - Updates index.md
 
@@ -294,7 +294,7 @@ git diff main...HEAD
 
 - [ ] Run lint and type-check - Must pass
 - [ ] Commit with proper message format
-- [ ] Run `add-session.sh` to record progress
+- [ ] Run `add-session.sh` to record session
 - [ ] Archive feature if completed with `feature.sh archive`
 
 ---

package/dist/templates/markdown/workflow.md.txt

@@ -40,14 +40,14 @@
 |   |-- feature.sh           # Manage features
 |   |-- get-context.sh       # Get session context
 |   \-- add-session.sh       # One-click session recording
-|-- agent-traces/       # AI Agent work progress records
-|   |-- index.md         # Progress index + Session template
+|-- agent-traces/       # AI Agent work traces records
+|   |-- index.md         # Traces index + Session template
 |   \-- {developer}/     # Per-developer directories
 |       |-- index.md     # Personal index (with @@@auto markers)
 |       |-- features/    # Feature directories
 |       |   \-- {day}-{name}/
 |       |       \-- feature.json
-|       \-- progress-N.md  # Progress files (sequential numbering)
+|       \-- traces-N.md  # Traces files (sequential numbering)
 |-- structure/           # [!] MUST READ before coding
 |   |-- frontend/        # Frontend guidelines (if applicable)
 |   |   |-- index.md               # Start here - guidelines index
@@ -168,7 +168,7 @@ After code is committed, use:
 ```
 
 This automatically:
-1. Detects current progress file
+1. Detects current traces file
 2. Creates new file if 2000-line limit exceeded
 3. Appends session content
 4. Updates index.md (sessions count, history table)
@@ -186,7 +186,7 @@ Use `/finish-work` command to run through:
 
 ## File Descriptions
 
-### 1. agent-traces/ - Agent Work Progress
+### 1. agent-traces/ - Agent Work Traces
 
 **Purpose**: Record each AI Agent session's work content
 
@@ -199,7 +199,7 @@ agent-traces/
     |-- features/         # Feature directories
     |   \-- {day}-{name}/ # Each feature is a directory
     |       \-- feature.json
-    \-- progress-N.md     # Progress files (sequential: 1, 2, 3...)
+    \-- traces-N.md     # Traces files (sequential: 1, 2, 3...)
 ```
 
 **When to update**:

package/dist/templates/scripts/add-session.sh.txt

@@ -1,5 +1,5 @@
 #!/bin/bash
-# Add a new session to progress file and update index.md
+# Add a new session to traces file and update index.md
 #
 # Usage:
 #   ./.trellis/scripts/add-session.sh --title "Title" --commit "hash" --summary "Summary"
@@ -30,9 +30,9 @@ get_latest_progress_info() {
   local latest_file=""
   local latest_num=0
 
-  for f in "$DEV_DIR"/progress-*.md; do
+  for f in "$DEV_DIR"/traces-*.md; do
     if [[ -f "$f" ]]; then
-      local num=$(basename "$f" | sed 's/progress-\([0-9]*\)\.md/\1/')
+      local num=$(basename "$f" | sed 's/traces-\([0-9]*\)\.md/\1/')
       if [[ "$num" -gt "$latest_num" ]]; then
         latest_num=$num
         latest_file="$f"
@@ -57,9 +57,9 @@ count_progress_files() {
   local result=""
   local progress_info=$(get_latest_progress_info)
   local active_num=$(echo "$progress_info" | cut -d: -f2)
-  local active_file="progress-$active_num.md"
+  local active_file="traces-$active_num.md"
 
-  for f in $(ls -v "$DEV_DIR"/progress-*.md 2>/dev/null | sort -t- -k2 -n -r); do
+  for f in $(ls -v "$DEV_DIR"/traces-*.md 2>/dev/null | sort -t- -k2 -n -r); do
     if [[ -f "$f" ]]; then
       local filename=$(basename "$f")
       local lines=$(wc -l < "$f" | tr -d ' ')
@@ -76,15 +76,15 @@ count_progress_files() {
   echo "$result" | sed '/^$/d'
 }
 
-create_new_progress_file() {
+create_new_traces_file() {
   local num=$1
   local prev_num=$((num - 1))
-  local new_file="$DEV_DIR/progress-$num.md"
+  local new_file="$DEV_DIR/traces-$num.md"
 
   cat > "$new_file" << EOF
-# Agent Progress - $DEVELOPER (Part $num)
+# Agent Traces - $DEVELOPER (Part $num)
 
-> Continuation from \`progress-$prev_num.md\` (archived at ~$MAX_LINES lines)
+> Continuation from \`traces-$prev_num.md\` (archived at ~$MAX_LINES lines)
 > Started: $TODAY
 
 ---
@@ -317,7 +317,7 @@ add_session() {
   echo "Title: $title" >&2
   echo "Commit: $commit" >&2
   echo "" >&2
-  echo "Current progress file: progress-$current_num.md" >&2
+  echo "Current traces file: traces-$current_num.md" >&2
   echo "Current lines: $current_lines" >&2
   echo "New content lines: $content_lines" >&2
   echo "Total after append: $((current_lines + content_lines))" >&2
@@ -328,8 +328,8 @@ add_session() {
 
   if [[ $((current_lines + content_lines)) -gt $MAX_LINES ]]; then
     target_num=$((current_num + 1))
-    echo "[!] Exceeds $MAX_LINES lines, creating progress-$target_num.md" >&2
-    target_file=$(create_new_progress_file "$target_num")
+    echo "[!] Exceeds $MAX_LINES lines, creating traces-$target_num.md" >&2
+    target_file=$(create_new_traces_file "$target_num")
     echo "Created: $target_file" >&2
   fi
 
@@ -339,7 +339,7 @@ add_session() {
   echo "" >&2
 
   # Update index.md directly
-  local active_file="progress-$target_num.md"
+  local active_file="traces-$target_num.md"
   update_index "$title" "$commit" "$new_session" "$active_file"
 
   echo "" >&2
@@ -355,7 +355,7 @@ add_session() {
 show_help() {
   echo "Usage: $0 --title \"Title\" [options]"
   echo ""
-  echo "Add a new session to progress file and update index.md automatically."
+  echo "Add a new session to traces file and update index.md automatically."
   echo ""
   echo "Options:"
   echo "  --title TEXT       Session title (required)"

package/dist/templates/scripts/common/developer.sh.txt

@@ -40,34 +40,34 @@ EOF
   mkdir -p "$progress_dir/$DIR_FEATURES"
   mkdir -p "$progress_dir/$DIR_FEATURES/$DIR_ARCHIVE"
 
-  # Create initial progress file
-  local progress_file="$progress_dir/progress-1.md"
-  if [[ ! -f "$progress_file" ]]; then
-    cat > "$progress_file" << PROGRESS_EOF
-# Agent Progress - $name (Part 1)
+  # Create initial traces file
+  local traces_file="$progress_dir/traces-1.md"
+  if [[ ! -f "$traces_file" ]]; then
+    cat > "$traces_file" << TRACES_EOF
+# Agent Traces - $name (Part 1)
 
-> AI development session progress tracking
+> AI development session traces
 > Started: $(date +%Y-%m-%d)
 
 ---
 
-PROGRESS_EOF
+TRACES_EOF
   fi
 
   # Create index.md with markers for auto-update
   local index_file="$progress_dir/index.md"
   if [[ ! -f "$index_file" ]]; then
     cat > "$index_file" << INDEX_EOF
-# Agent Progress Index - $name
+# Agent Traces Index - $name
 
-> Progress tracking for AI development sessions.
+> Traces tracking for AI development sessions.
 
 ---
 
 ## Current Status
 
 <!-- @@@auto:current-status -->
-- **Active File**: \`progress-1.md\`
+- **Active File**: \`traces-1.md\`
 - **Total Sessions**: 0
 - **Last Active**: -
 <!-- @@@/auto:current-status -->
@@ -79,7 +79,7 @@ PROGRESS_EOF
 <!-- @@@auto:active-documents -->
 | File | Lines | Status |
 |------|-------|--------|
-| \`progress-1.md\` | ~0 | Active |
+| \`traces-1.md\` | ~0 | Active |
 <!-- @@@/auto:active-documents -->
 
 ---
@@ -95,8 +95,8 @@ PROGRESS_EOF
 
 ## Notes
 
-- Sessions are appended to progress files
-- New progress file created when current exceeds 2000 lines
+- Sessions are appended to traces files
+- New traces file created when current exceeds 2000 lines
 - Use \`add-session.sh\` to record sessions
 INDEX_EOF
   fi

package/dist/templates/scripts/common/git-context.sh.txt

@@ -88,7 +88,7 @@ output_json() {
     "active": $features_json,
     "directory": "$DIR_WORKFLOW/$DIR_PROGRESS/$developer/$DIR_FEATURES"
   },
-  "progress": {
+  "traces": {
     "file": "$progress_relative",
     "lines": $progress_lines,
     "nearLimit": $([ "$progress_lines" -gt 1800 ] && echo "true" || echo "false")
@@ -190,23 +190,23 @@ output_text() {
   echo "Total: $feature_count active feature(s)"
   echo ""
 
-  echo "## PROGRESS FILE"
-  local progress_file=$(get_active_progress_file "$repo_root")
-  if [[ -n "$progress_file" ]]; then
-    local lines=$(count_lines "$progress_file")
-    local relative="$DIR_WORKFLOW/$DIR_PROGRESS/$developer/$(basename "$progress_file")"
+  echo "## TRACES FILE"
+  local traces_file=$(get_active_progress_file "$repo_root")
+  if [[ -n "$traces_file" ]]; then
+    local lines=$(count_lines "$traces_file")
+    local relative="$DIR_WORKFLOW/$DIR_PROGRESS/$developer/$(basename "$traces_file")"
     echo "Active file: $relative"
     echo "Line count: $lines / 2000"
     if [[ "$lines" -gt 1800 ]]; then
       echo "[!] WARNING: Approaching 2000 line limit!"
     fi
   else
-    echo "No progress file found"
+    echo "No traces file found"
   fi
   echo ""
 
   echo "## PATHS"
-  echo "Progress dir: $DIR_WORKFLOW/$DIR_PROGRESS/$developer/"
+  echo "Traces dir: $DIR_WORKFLOW/$DIR_PROGRESS/$developer/"
   echo "Features dir: $DIR_WORKFLOW/$DIR_PROGRESS/$developer/$DIR_FEATURES/"
   echo "Index file: $DIR_WORKFLOW/$DIR_PROGRESS/$developer/index.md"
   echo ""

package/dist/templates/scripts/common/paths.sh.txt

@@ -8,8 +8,8 @@
 #   get_repo_root          - Get repository root directory
 #   get_developer          - Get developer name
 #   get_features_dir       - Get features directory
-#   get_progress_dir       - Get progress directory
-#   get_active_progress_file - Get current progress file
+#   get_progress_dir       - Get traces directory
+#   get_active_progress_file - Get current traces file
 
 # =============================================================================
 # Path Constants (change here to rename directories)
@@ -108,9 +108,9 @@ get_active_progress_file() {
 
   local latest=""
   local highest=0
-  for f in "$progress_dir"/progress-*.md; do
+  for f in "$progress_dir"/traces-*.md; do
     if [[ -f "$f" ]]; then
-      local num=$(basename "$f" | sed 's/progress-//' | sed 's/\.md//')
+      local num=$(basename "$f" | sed 's/traces-//' | sed 's/\.md//')
       if [[ "$num" =~ ^[0-9]+$ ]] && [[ "$num" -gt "$highest" ]]; then
         highest=$num
         latest="$f"