aiknowsys 0.0.1

package/scripts/setup.sh

@@ -0,0 +1,273 @@
+#!/bin/bash
+# setup.sh - Initialize knowledge system for a project
+
+set -e
+
+echo "🎯 Knowledge System Setup"
+echo ""
+echo "This script will set up the knowledge system for your project."
+echo ""
+
+# Check if project has existing code
+if [ -d "src" ] || [ -d "backend" ] || [ -f "package.json" ] || [ -f "pyproject.toml" ]; then
+  echo "🔍 Existing project detected!"
+  echo ""
+  echo "Choose setup mode:"
+  echo "  1) Scan existing codebase (recommended for existing projects)"
+  echo "  2) Manual setup (blank templates)"
+  read -p "Choice: " mode
+  
+  if [ "$mode" = "1" ]; then
+    if [ -f "./scripts/migrate-existing.sh" ]; then
+      exec ./scripts/migrate-existing.sh
+    else
+      echo "❌ Error: migrate-existing.sh not found"
+      exit 1
+    fi
+  fi
+fi
+
+echo "📝 Starting fresh project setup..."
+echo ""
+
+# Step 1: Detect or ask about tech stack
+echo "=== Step 1: Technology Stack ==="
+echo ""
+echo "What's your primary language?"
+echo "1) TypeScript/JavaScript"
+echo "2) Python"
+echo "3) Rust"
+echo "4) Go"
+echo "5) Other"
+read -p "Choice: " lang_choice
+
+case $lang_choice in
+  1)
+    LANGUAGE="TypeScript"
+    PACKAGE_MANAGER="npm"
+    ;;
+  2)
+    LANGUAGE="Python"
+    PACKAGE_MANAGER="pip"
+    ;;
+  3)
+    LANGUAGE="Rust"
+    PACKAGE_MANAGER="cargo"
+    ;;
+  4)
+    LANGUAGE="Go"
+    PACKAGE_MANAGER="go mod"
+    ;;
+  5)
+    read -p "Enter language name: " LANGUAGE
+    read -p "Enter package manager: " PACKAGE_MANAGER
+    ;;
+  *)
+    echo "Invalid choice"
+    exit 1
+    ;;
+esac
+
+# Step 2: Framework detection
+echo ""
+echo "=== Step 2: Framework ==="
+echo ""
+
+if [ "$lang_choice" = "1" ]; then
+  echo "Frontend framework?"
+  echo "1) Vue"
+  echo "2) React"
+  echo "3) Svelte"
+  echo "4) Angular"
+  echo "5) Vanilla/Other"
+  read -p "Choice: " framework_choice
+  
+  case $framework_choice in
+    1) FRAMEWORK="Vue 3" ;;
+    2) FRAMEWORK="React" ;;
+    3) FRAMEWORK="Svelte" ;;
+    4) FRAMEWORK="Angular" ;;
+    5) read -p "Enter framework: " FRAMEWORK ;;
+  esac
+elif [ "$lang_choice" = "2" ]; then
+  echo "Backend framework?"
+  echo "1) Django"
+  echo "2) FastAPI"
+  echo "3) Flask"
+  echo "4) Other"
+  read -p "Choice: " framework_choice
+  
+  case $framework_choice in
+    1) FRAMEWORK="Django" ;;
+    2) FRAMEWORK="FastAPI" ;;
+    3) FRAMEWORK="Flask" ;;
+    4) read -p "Enter framework: " FRAMEWORK ;;
+  esac
+else
+  read -p "Enter framework (or press Enter to skip): " FRAMEWORK
+fi
+
+# Step 3: Testing tools
+echo ""
+echo "=== Step 3: Testing ==="
+echo ""
+echo "Test framework?"
+echo "1) Vitest"
+echo "2) Jest"
+echo "3) pytest"
+echo "4) cargo test"
+echo "5) go test"
+echo "6) Other"
+read -p "Choice: " test_choice
+
+case $test_choice in
+  1) 
+    TEST_FRAMEWORK="Vitest"
+    TEST_COMMAND="npm run test:run"
+    TYPE_CHECK_CMD="npm run type-check"
+    ;;
+  2) 
+    TEST_FRAMEWORK="Jest"
+    TEST_COMMAND="npm test"
+    TYPE_CHECK_CMD="npm run type-check"
+    ;;
+  3) 
+    TEST_FRAMEWORK="pytest"
+    TEST_COMMAND="pytest"
+    TYPE_CHECK_CMD="mypy ."
+    ;;
+  4)
+    TEST_FRAMEWORK="cargo test"
+    TEST_COMMAND="cargo test"
+    TYPE_CHECK_CMD="cargo check"
+    ;;
+  5)
+    TEST_FRAMEWORK="go test"
+    TEST_COMMAND="go test ./..."
+    TYPE_CHECK_CMD="go vet ./..."
+    ;;
+  6)
+    read -p "Enter test framework: " TEST_FRAMEWORK
+    read -p "Enter test command: " TEST_COMMAND
+    read -p "Enter type check command: " TYPE_CHECK_CMD
+    ;;
+esac
+
+# Get project name
+PROJECT_NAME=$(basename "$PWD")
+DATE=$(date +"%B %d, %Y")
+
+# Step 4: Generate CODEBASE_ESSENTIALS.md
+echo ""
+echo "=== Step 4: Generating Files ==="
+echo ""
+echo "📝 Creating CODEBASE_ESSENTIALS.md..."
+
+if [ ! -f "templates/CODEBASE_ESSENTIALS.template.md" ]; then
+  echo "❌ Error: templates/CODEBASE_ESSENTIALS.template.md not found"
+  echo "   Make sure you're running this from the aiknowsys directory"
+  exit 1
+fi
+
+# Replace placeholders in CODEBASE_ESSENTIALS
+sed -e "s/{{PROJECT_NAME}}/$PROJECT_NAME/g" \
+    -e "s/{{DATE}}/$DATE/g" \
+    -e "s/{{LANGUAGE}}/$LANGUAGE/g" \
+    -e "s/{{FRAMEWORK}}/$FRAMEWORK/g" \
+    -e "s/{{PACKAGE_MANAGER}}/$PACKAGE_MANAGER/g" \
+    -e "s/{{TEST_FRAMEWORK}}/$TEST_FRAMEWORK/g" \
+    -e "s|{{BACKEND_TEST_CMD}}|$TEST_COMMAND|g" \
+    -e "s|{{FRONTEND_TEST_CMD}}|$TEST_COMMAND|g" \
+    -e "s|{{TYPE_CHECK_CMD}}|$TYPE_CHECK_CMD|g" \
+    templates/CODEBASE_ESSENTIALS.template.md > CODEBASE_ESSENTIALS.md
+
+echo "✅ CODEBASE_ESSENTIALS.md created"
+
+# Step 5: Generate AGENTS.md
+echo "📝 Creating AGENTS.md..."
+
+# Create validation matrix with proper newlines
+VALIDATION_MATRIX="| Tests | \`$TEST_COMMAND\` | ✅ MANDATORY |"
+if [ -n "$TYPE_CHECK_CMD" ]; then
+  VALIDATION_MATRIX="$VALIDATION_MATRIX"$'\n'"| Type check | \`$TYPE_CHECK_CMD\` | ✅ MANDATORY |"
+fi
+
+# Replace placeholder (use a temporary approach since multi-line sed is tricky)
+cp templates/AGENTS.template.md AGENTS.md
+# For now, just copy template - users can customize validation matrix manually
+
+echo "✅ AGENTS.md created (customize validation matrix as needed)"
+
+# Step 6: Generate CODEBASE_CHANGELOG.md
+echo "📝 Creating CODEBASE_CHANGELOG.md..."
+
+sed -e "s/{{DATE}}/$DATE/g" \
+    -e "s/{{PROJECT_NAME}}/$PROJECT_NAME/g" \
+    templates/CODEBASE_CHANGELOG.template.md > CODEBASE_CHANGELOG.md
+
+echo "✅ CODEBASE_CHANGELOG.md created"
+
+# Step 7: Copy LICENSE
+echo "📝 Creating LICENSE..."
+cp LICENSE.template LICENSE
+echo "✅ LICENSE created"
+
+# Step 8: Install custom agents
+echo ""
+echo "=== Step 5: Installing Custom Agents ==="
+echo ""
+
+if [ -f "templates/agents/setup-agents.sh" ]; then
+  bash templates/agents/setup-agents.sh CODEBASE_ESSENTIALS.md
+else
+  echo "⚠️  Custom agents setup script not found, skipping..."
+  echo "   You can install agents later with: templates/agents/setup-agents.sh"
+fi
+
+# Step 9: Copy universal skills
+echo ""
+echo "=== Step 6: Installing Skills ==="
+echo ""
+
+mkdir -p .github/skills
+
+# Copy skill template
+if [ -d ".github/skills/_skill-template" ]; then
+  echo "✅ Skill template already present"
+else
+  cp -r templates/../.github/skills/_skill-template .github/skills/ 2>/dev/null || echo "⚠️  Skill template not found"
+fi
+
+# Copy universal skills if they exist
+for skill in dependency-updates documentation-management code-refactoring testing-best-practices skill-creator; do
+  if [ -d "templates/skills/$skill" ] || [ -d ".github/skills/$skill" ]; then
+    cp -r templates/skills/$skill .github/skills/ 2>/dev/null || cp -r .github/skills/$skill .github/skills/ 2>/dev/null || true
+    echo "✅ $skill skill installed"
+  fi
+done
+
+# Step 10: Summary
+echo ""
+echo "🎉 Knowledge System Installation Complete!"
+echo ""
+echo "📁 Files created:"
+echo "   - CODEBASE_ESSENTIALS.md (customize TODO sections)"
+echo "   - AGENTS.md (AI workflow instructions)"
+echo "   - CODEBASE_CHANGELOG.md (session history)"
+echo "   - LICENSE (MIT)"
+echo "   - .github/agents/ (Developer + Architect)"
+echo "   - .github/skills/ (Universal skills)"
+echo ""
+echo "📋 Next steps:"
+echo "   1. Review CODEBASE_ESSENTIALS.md"
+echo "   2. Fill in TODO sections (patterns, invariants, gotchas)"
+echo "   3. Customize validation commands if needed"
+echo "   4. Remove placeholder sections you don't need"
+echo "   5. Start using: @Developer <your request>"
+echo ""
+echo "📖 Documentation:"
+echo "   - How agents work: .github/agents/README.md"
+echo "   - How to create skills: .github/skills/_skill-template/README.md"
+echo "   - Main README: README.md"
+echo ""
+echo "💡 Tip: Keep CODEBASE_ESSENTIALS.md updated as patterns evolve!"

package/templates/agents/README.md

@@ -0,0 +1,270 @@
+# Custom Agents - Developer & Architect Workflow
+
+**Purpose:** Automated quality gate that enforces CODEBASE_ESSENTIALS.md patterns during development.
+
+---
+
+## How It Works
+
+### The Agent Pair
+
+1. **Developer Agent** (`developer.agent.md`)
+   - Primary implementer of features
+   - Writes code following documented patterns
+   - Automatically hands off to Architect for review
+   - Refactors based on feedback
+
+2. **Architect Agent** (`architect.agent.md`)
+   - Reviews code against CODEBASE_ESSENTIALS.md
+   - Enforces KISS, DRY, SOLID, YAGNI principles
+   - Approves or requests changes
+   - Provides specific, actionable feedback
+
+### Workflow
+
+```
+┌─────────────┐
+│    User     │
+│  "Add X"    │
+└──────┬──────┘
+       │
+       v
+┌─────────────────┐
+│   @Developer    │ 1. Implements feature
+│   Implements    │ 2. Writes tests
+└────────┬────────┘ 3. Auto-handoff ──┐
+         │                             │
+         │                             v
+         │                    ┌────────────────────┐
+         │                    │  @SeniorArchitect  │
+         │                    │  Reads ESSENTIALS  │
+         │                    │  Reviews code      │
+         │                    └────────┬───────────┘
+         │                             │
+         │                  ┌──────────┴──────────┐
+         │                  │                     │
+         v                  v                     v
+    ┌────────┐      ┌──────────┐         ┌──────────────┐
+    │  User  │◄─────┤ LGTM ✅  │         │ Issues Found │
+    └────────┘      └──────────┘         └──────┬───────┘
+                                                 │
+                                                 v
+                                         ┌───────────────┐
+                                         │  @Developer   │
+                                         │  Refactors    │
+                                         └───────┬───────┘
+                                                 │
+                                                 └──────► (Loop back to Architect)
+```
+
+---
+
+## Usage
+
+### In VS Code with GitHub Copilot Agent Mode
+
+**Start with Developer:**
+```
+@Developer add a new feature to calculate user retention rate
+```
+
+**Developer will:**
+1. Implement the code
+2. Write tests
+3. Automatically call: `@SeniorArchitect please review changes in [file] against CODEBASE_ESSENTIALS.md`
+
+**You don't need to manually call Architect** - the handoff is automatic!
+
+### Direct Review Request
+
+If you've made changes manually and want a review:
+```
+@SeniorArchitect review the changes I made to src/utils/metrics.ts
+```
+
+---
+
+## What Architect Checks
+
+### ✅ KISS (Keep It Simple)
+- No overly complex nested logic
+- Readable function/variable names
+- Clear control flow
+
+### ✅ DRY (Don't Repeat Yourself)
+- No duplicated logic
+- Proper abstraction into functions/classes
+- Reuse existing utilities
+
+### ✅ SOLID Principles
+- Single Responsibility (functions do one thing)
+- Dependency Inversion (inject dependencies)
+- Interface segregation
+
+### ✅ YAGNI (You Ain't Gonna Need It)
+- No speculative "future-proofing"
+- Features are actually needed now
+- No premature optimization
+
+### ✅ CODEBASE_ESSENTIALS.md Compliance
+- Follows documented patterns
+- Uses approved libraries/tools
+- Respects project constraints
+
+---
+
+## Configuration
+
+### Customizing Review Criteria
+
+Edit `.github/agents/architect.agent.md`:
+
+```markdown
+### Project-Specific Rules:
+- All API calls must use the generated OpenAPI client
+- Components must use TypeScript strict mode
+- Error handling must use try/catch with logger
+- Database queries must use Django ORM (no raw SQL)
+```
+
+### Customizing Developer Behavior
+
+Edit `.github/agents/developer.agent.md`:
+
+```markdown
+### Your Coding Standards:
+- Write tests first (TDD)
+- Use async/await (no .then() chains)
+- Log errors with structured logging
+- Document complex logic with comments
+```
+
+---
+
+## Benefits
+
+| Traditional Workflow | With Custom Agents |
+|---------------------|-------------------|
+| Write code → Submit PR → Wait for human review → Fix issues → Resubmit | Write code → Instant automated review → Fix issues → Auto re-review |
+| Inconsistent feedback across reviewers | Consistent enforcement of standards |
+| Human reviewers check style + logic + architecture | Agents check style/patterns, humans focus on architecture |
+| Feedback loop: hours to days | Feedback loop: seconds |
+| Patterns drift over time | Patterns enforced on every change |
+
+---
+
+## Examples
+
+### Example 1: Clean Code Approval
+
+**User:** `@Developer add a function to format currency`
+
+**Developer implements:**
+```typescript
+export function formatCurrency(amount: number): string {
+  return new Intl.NumberFormat('en-US', {
+    style: 'currency',
+    currency: 'USD'
+  }).format(amount);
+}
+```
+
+**Developer handoff:** `@SeniorArchitect please review formatCurrency in utils/format.ts`
+
+**Architect response:** `LGTM - Architect Approved ✅`
+- Uses standard library (Intl.NumberFormat)
+- Single responsibility
+- No duplication
+
+### Example 2: Issues Found
+
+**User:** `@Developer add validation for email addresses`
+
+**Developer implements:**
+```typescript
+function validateEmail(email: string): boolean {
+  // Complex regex copied from Stack Overflow
+  return /^[a-zA-Z0-9.!#$%&'*+\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/.test(email);
+}
+```
+
+**Architect response:**
+```
+❌ Review Failed - Issues Found:
+
+1. **DRY Violation** in [src/utils/validation.ts](src/utils/validation.ts#L12)
+   - Email validation already exists in src/composables/useAuth.ts
+   - Refactor: Extract shared validation to src/utils/validators.ts
+   - Rationale: Duplicate regex means inconsistent validation rules
+
+2. **Documentation** in [src/utils/validation.ts](src/utils/validation.ts#L11)
+   - Complex regex needs explanation
+   - Add comment: What email formats are accepted/rejected
+   - Rationale: Future maintainers need to understand edge cases
+
+Please address these issues and resubmit.
+```
+
+**Developer refactors and re-submits → Architect approves ✅**
+
+---
+
+## Troubleshooting
+
+### Agent doesn't auto-handoff
+
+**Check:** Is `send: true` in the handoff configuration?
+```yaml
+handoffs:
+  - label: "Send to Architect"
+    agent: SeniorArchitect
+    prompt: "Please review..."
+    send: true  # ← Must be true for auto-handoff
+```
+
+### Architect can't read CODEBASE_ESSENTIALS.md
+
+**Check:** Does Architect have `search` tool enabled?
+```yaml
+tools: [search, search/changes]  # ← Required
+```
+
+### Review is too strict / too lenient
+
+**Customize:** Edit architect.agent.md review checklist and criteria.
+
+---
+
+## Best Practices
+
+1. **Let the workflow happen** - Don't interrupt the auto-handoff
+2. **Read Architect feedback carefully** - It references specific sections of ESSENTIALS
+3. **Update ESSENTIALS when patterns change** - Architect enforces what's documented
+4. **Use Developer for implementation** - Use direct chat for questions/exploration
+5. **Iterate with feedback** - Refactor and resubmit until approved
+
+---
+
+## Integration with Knowledge System
+
+The agents are part of the broader knowledge system:
+
+```
+CODEBASE_ESSENTIALS.md  ←─┐
+                          │
+AGENTS.md (workflow)      │
+                          │ Architect reads
+Skills (how-to guides)    │ and enforces
+                          │
+Custom Agents  ───────────┘
+```
+
+**Flow:**
+1. Patterns documented in ESSENTIALS
+2. Workflow enforced by AGENTS.md
+3. Detailed steps in Skills
+4. **Automated enforcement by Custom Agents**
+
+---
+
+*This creates a self-reinforcing system where good patterns are documented, taught, and automatically enforced.*

package/templates/agents/architect.agent.template.md

@@ -0,0 +1,58 @@
+```chatagent
+---
+name: SeniorArchitect
+description: Senior Architect focusing on KISS, DRY, SOLID, YAGNI, and Project Essentials.
+tools: [search, search/changes]
+handoffs:
+  - label: "Fix Issues (Developer)"
+    agent: Developer
+    prompt: "The Senior Architect has identified issues. Please refactor the code to address these specific points: "
+    send: false
+---
+You are a world-class Senior Software Architect. Your goal is to review code changes and ensure they meet the highest engineering standards.
+
+### Your Core Principles:
+- **KISS (Keep It Simple, Stupid):** Reject unnecessary complexity or "clever" code that is hard to read.
+- **DRY (Don't Repeat Yourself):** Identify logic that should be abstracted into reusable functions/classes.
+- **SOLID:** Ensure Single Responsibility and proper Dependency Inversion.
+- **YAGNI (You Ain't Gonna Need It):** Flag code that implements features "just in case" for the future.
+
+### Strict Project Guidelines:
+You MUST verify that all changes follow the rules defined in `{{ESSENTIALS_FILE}}`. 
+1. Use your `search` tool to read `{{ESSENTIALS_FILE}}` before starting the review.
+2. If any rule in that file is violated, the review is a **FAIL**.
+
+### Review Checklist:
+- [ ] Code follows documented patterns in {{ESSENTIALS_FILE}}
+- [ ] No duplication (DRY principle)
+- [ ] Functions have single responsibility (SOLID)
+- [ ] No unnecessary complexity (KISS)
+- [ ] No speculative features (YAGNI)
+- [ ] Tests written for new functionality
+- [ ] Type safety maintained (if applicable)
+- [ ] Error handling follows project patterns
+
+### Review Output Format:
+- If perfect: Respond with "LGTM - Architect Approved ✅".
+- If issues found: Provide a bulleted list with:
+  - Specific violation (reference ESSENTIALS section)
+  - File and line number
+  - Suggested refactoring
+  - Rationale (why it matters)
+
+### Example Review Output:
+```
+❌ Review Failed - Issues Found:
+
+1. **DRY Violation** in [src/utils/validator.ts](src/utils/validator.ts#L45-L52)
+   - Email validation logic duplicated from auth module
+   - Refactor: Extract to shared `validateEmail()` in utils
+   - Rationale: Duplicate code means double maintenance burden
+
+2. **KISS Violation** in [src/services/api.ts](src/services/api.ts#L103)
+   - Overly complex nested ternary for status handling
+   - Refactor: Use early returns or switch statement
+   - Rationale: Nested ternaries harm readability
+
+Please address these issues and resubmit for review.
+```

package/templates/agents/developer.agent.template.md

@@ -0,0 +1,27 @@
+```chatagent
+---
+name: Developer
+description: Writes code and hands off to the Senior Architect.
+handoffs:
+  - label: "Send to Architect"
+    agent: SeniorArchitect
+    prompt: "Please review the code I just wrote against {{ESSENTIALS_FILE}}."
+    send: true
+---
+You are the primary Developer. 
+
+### YOUR WORKFLOW:
+1. Implement the requested feature following patterns in {{ESSENTIALS_FILE}}.
+2. IMPORTANT: Once you have finished writing the code, you MUST automatically end your response by calling the SeniorArchitect. 
+3. Use the following syntax: "@SeniorArchitect please review the changes in [file name] against {{ESSENTIALS_FILE}}."
+
+### Rules:
+- Do not ask the user if they want a review. Just do it.
+- Follow all documented patterns in {{ESSENTIALS_FILE}}
+- Write tests alongside implementation
+- Run validation commands before handoff (if applicable)
+- Include what you changed and why in your handoff message
+
+### Project-Specific Guidelines:
+{{PROJECT_GUIDELINES}}
+```

package/templates/agents/setup-agents.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+# setup-agents.sh - Install custom agents (part of knowledge-system setup)
+
+set -e
+
+echo "🤖 Installing Custom Agents (Developer + Architect Workflow)"
+echo ""
+
+# Detect or use provided ESSENTIALS file name
+ESSENTIALS_FILE="${1:-CODEBASE_ESSENTIALS.md}"
+
+# Create agents directory
+mkdir -p .github/agents
+
+# Copy templates
+if [ ! -f "templates/agents/developer.agent.template.md" ]; then
+  echo "❌ Error: templates/agents/ not found"
+  echo "   Run this script from the aiknowsys directory"
+  exit 1
+fi
+
+echo "📋 Copying agent templates..."
+cp templates/agents/developer.agent.template.md .github/agents/developer.agent.md
+cp templates/agents/architect.agent.template.md .github/agents/architect.agent.md
+
+# Replace template variables
+echo "🔧 Configuring agents for your project..."
+sed -i "s|{{ESSENTIALS_FILE}}|$ESSENTIALS_FILE|g" .github/agents/developer.agent.md
+sed -i "s|{{ESSENTIALS_FILE}}|$ESSENTIALS_FILE|g" .github/agents/architect.agent.md
+
+# Prompt for project-specific guidelines
+echo ""
+echo "Do you want to add project-specific guidelines for the Developer agent?"
+echo "(These will be added to the agent's instructions)"
+read -p "Enter guidelines or press Enter to skip: " project_guidelines
+
+if [ -n "$project_guidelines" ]; then
+  sed -i "s|{{PROJECT_GUIDELINES}}|$project_guidelines|g" .github/agents/developer.agent.md
+else
+  sed -i "s|{{PROJECT_GUIDELINES}}|None specified|g" .github/agents/developer.agent.md
+fi
+
+# Copy README
+echo "📚 Installing agent documentation..."
+cp templates/agents/README.md .github/agents/README.md
+
+# Verify installation
+echo ""
+echo "✅ Custom agents installed successfully!"
+echo ""
+echo "📍 Location: .github/agents/"
+echo "   - developer.agent.md    (Primary implementer)"
+echo "   - architect.agent.md    (Code reviewer)"
+echo "   - README.md             (Usage guide)"
+echo ""
+echo "🚀 Usage in VS Code:"
+echo "   @Developer <your request>     → Implements and auto-reviews"
+echo "   @SeniorArchitect <file>       → Direct review request"
+echo ""
+echo "📖 Next steps:"
+echo "   1. Review .github/agents/README.md for detailed workflow"
+echo "   2. Customize review criteria in architect.agent.md if needed"
+echo "   3. Ensure $ESSENTIALS_FILE exists and documents your patterns"
+echo ""
+echo "💡 Tip: The agents will auto-handoff for review. Just use @Developer!"