Portfolio Control Features

Your agentic portfolio system now has 5 powerful control features.

1. Interactive Approval Mode 👆

Get final say before saving each variation.

node coordinator.mjs --interactive
# or
node coordinator.mjs -i

What happens:

After each evaluation, you'll see:

────────────────────────────────────────────────────────────
INTERACTIVE APPROVAL
────────────────────────────────────────────────────────────

Score: 82.3/100
Approved by: 8/10 roles

Key improvements:
  • Enhanced quantifiable outcomes with specific metrics
  • Strengthened leadership narrative throughout case studies
  • Added stakeholder management examples

Primary focus: Head of Product Design

Options:
  [s] Save this variation
  [r] Reject and iterate with feedback
  [v] View full evaluation details
  [q] Quit

Your choice (s/r/v/q):

Commands:

• s or save — Save this variation
• r or reject — Reject and iterate with feedback
• v or view — See detailed evaluations from all hiring managers
• q or quit — Stop the loop

2. Preview Mode (Dry Run) 🔍

Test settings without saving anything.

node coordinator.mjs --preview
# or
node coordinator.mjs --dry-run

What it does:

• Shows what would be generated
• Displays scores and feedback
• Does NOT write any files
• Perfect for testing settings

3. Variation Management 📋

Control your portfolio variations.

List All Variations

node coordinator.mjs --list
# or
node coordinator.mjs -l

Shows:

📋 Portfolio Variations

👑 ⭐ portfolio-agentic-1788768875441
     Score: 82.3/100 | Focus: Head of Product Design
     Iteration: 12 | Created: 9/7/2026, 8:14:35 AM

     portfolio-agentic-1788768855400
     Score: 80.9/100 | Focus: Staff Product Designer
     Iteration: 2 | Created: 9/7/2026, 8:14:15 AM

Total: 10 variations

👑 = Highest score
⭐ = Starred (your favorites)

Star a Variation

Mark your favorites:

node coordinator.mjs --star=portfolio-agentic-1788768875441

Stars appear in the archive index and list view.

Delete a Variation

Remove unwanted variations:

node coordinator.mjs --delete=portfolio-agentic-1788768853384

Asks for confirmation, then:

• Removes from state
• Deletes files
• Updates archive index

Compare to Baseline

See what changed:

node coordinator.mjs --compare=portfolio-agentic-1788768875441

Shows:

• Score breakdown
• Key improvements
• Which roles approved/rejected
• Specific concerns from hiring managers

4. Focus Mode 🎯

Tell the system what to improve.

node coordinator.mjs --focus="Add more quantifiable metrics to all projects"

What happens:

• Your focus becomes the top priority improvement
• System still adds other enhancements
• All variations emphasize your directive

Examples:

# More specific outcomes
node coordinator.mjs --focus="Add team size and reporting structure"

# Better evidence
node coordinator.mjs --focus="Include specific project timelines and deliverables"

# Leadership emphasis
node coordinator.mjs --focus="Expand stakeholder management examples"

# Combine with preview
node coordinator.mjs --focus="Quantify business impact" --preview

5. Role-Specific Generation 🎭

Target specific roles only.

# Just these two roles
node coordinator.mjs --roles="Head of Product Design,VP Product Design"

# One role
node coordinator.mjs --roles="Director of Design"

# Most senior roles
node coordinator.mjs --roles="VP Product Design,Director of Design,Head of Product Design"

What it does:

• Only evaluates with specified hiring managers
• Faster iterations (fewer roles to score)
• More focused optimization
• Lower threshold needed for approval

Combine with other options:

# Interactive approval for VP role only
node coordinator.mjs --roles="VP Product Design" --interactive

# Preview focused improvements for two roles
node coordinator.mjs \
  --roles="Head of Product Design,Director of Design" \
  --focus="Emphasize team leadership" \
  --preview

Bonus: Custom Threshold ⚖️

Adjust approval strictness:

# More selective (only excellent variations)
node coordinator.mjs --threshold=85

# More exploratory (see more variations)
node coordinator.mjs --threshold=65

# Must be perfect
node coordinator.mjs --threshold=95 --interactive

Combining Features 🔧

Most powerful when combined:

Conservative Mode

# High bar + human approval
node coordinator.mjs --threshold=85 --interactive

Exploration Mode

# See lots of options, don't save yet
node coordinator.mjs --threshold=65 --preview

Targeted Optimization

# One role, specific focus, your approval
node coordinator.mjs \
  --roles="Head of Product Design" \
  --focus="Add quantifiable impact metrics" \
  --interactive

Quick Test

# Few roles, preview only, lower bar
node coordinator.mjs \
  --roles="Staff Product Designer,Principal Designer" \
  --threshold=70 \
  --preview

Getting Help 📖

node coordinator.mjs --help

Shows all options with examples.

Quick Reference Card

# GENERATE
node coordinator.mjs                    # Standard run
node coordinator.mjs -i                 # Interactive approval
node coordinator.mjs --preview          # Dry run (no files)

# CONTROL
node coordinator.mjs --focus="..."      # Direct improvements
node coordinator.mjs --roles="..."      # Target specific roles
node coordinator.mjs --threshold=75     # Set approval bar

# MANAGE
node coordinator.mjs --list             # List all variations
node coordinator.mjs --star=<id>        # Star a favorite
node coordinator.mjs --delete=<id>      # Delete variation
node coordinator.mjs --compare=<id>     # Compare to baseline

# COMBINE
node coordinator.mjs -i --focus="..." --roles="..."

Tips 💡

1. Start with preview — Always test settings first
2. Use interactive for important runs — Get final say
3. Focus guides but doesn't limit — Other improvements still happen
4. Star your best — Makes them easy to find later
5. Compare before using — See exactly what changed
6. Lower threshold for exploration — Higher for production

Files Created

• variations-metadata.json — Stores starred variations
• loop-state.json — Resumable state (as before)

Both are git-ignored by default.

What's Next?

All 5 control features are now live. Try:

# Interactive preview with focus
node coordinator.mjs \
  --preview \
  --interactive \
  --focus="Add more quantifiable outcomes" \
  --roles="Head of Product Design,VP Product Design"

Then when happy with the results:

# Same settings, but actually save
node coordinator.mjs \
  --interactive \
  --focus="Add more quantifiable outcomes" \
  --roles="Head of Product Design,VP Product Design"