Core Concepts

How SiftCoder works under the hood

⏱️ 10 minutes to understand

πŸ€– Multi-Agent Architecture

SiftCoder isn't one AI assistantβ€”it's a team of 11 specialized AI agents working together.

🎯 Planner Agent

Breaking Down Tasks

Receives your request and creates a detailed implementation plan

  • Analyzes requirements
  • Identifies dependencies
  • Creates step-by-step tasks
πŸ’» Coder Agent

Writing Production Code

Implements the planned tasks with clean, production-ready code

  • Writes code following patterns
  • Adheres to project conventions
  • Self-documents as it codes
πŸ” Investigator Agent

Safe Code Exploration

Read-only analysis to understand code without modifying it

  • Explores codebase safely
  • Finds relevant files
  • Understands patterns
πŸ“š Documenter Agent

Generating Documentation

Creates comprehensive documentation automatically

  • Architecture diagrams
  • API documentation
  • User guides
βœ… QA Reviewer Agent

Quality Validation

Reviews work for quality, completeness, and correctness

  • Code review standards
  • Acceptance criteria
  • Best practices
πŸ”§ QA Fixer Agent

Issue Resolution

Fixes issues identified by QA Reviewer automatically

  • Addresses feedback
  • Re-tests fixes
  • Iterates until passing

πŸ”„ Agent Collaboration Example

1

Planner breaks down "Add user login" into 8 tasks

2

Investigator finds existing auth code (read-only)

3

Coder implements login endpoint & tests

4

QA Reviewer validates implementation & security

5

QA Fixer addresses any issues found

6

Documenter updates API docs

⚑ Autonomous Workflows

SiftCoder executes complete workflows without your constant supervision.

πŸ—οΈ BUILD Workflow

Create entire projects from specifications

Spec β†’ Plan β†’ Code β†’ Test β†’ Review β†’ Fix β†’ Deploy

πŸ”§ MAINTAIN Workflow

Safe modifications to existing code

Investigate β†’ Scope β†’ Fix β†’ Validate β†’ Test

πŸ“š DOCUMENT Workflow

Generate comprehensive documentation

Analyze β†’ Diagram β†’ Write β†’ Format

🎯 Key Characteristics

  • Self-Healing: Automatically fixes build/test failures
  • Iterative: Continues until quality gates pass
  • Transparent: Shows progress at each step
  • Interruptible: Pause/resume at any time

πŸ›‘οΈ Safety Features

Powerful capabilities require powerful safety mechanisms.

🎯

Scope Management

Define which files AI can modify. Protected files are never touched without explicit approval.

/siftcoder:scope add src/critical/*

Protects critical files from modification

πŸ“‘

Blast Radius Validation

Ensures changes don't affect protected areas or break dependencies.

/siftcoder:blast-radius "Fix user auth"

Shows what will be affected before changes

πŸ’Ύ

Checkpoints

Save named restore points before making changes. Rollback instantly if needed.

/siftcoder:checkpoint save "before-refactor"

Creates a restore point

πŸ‘€

Preview Changes

See full diffs before any changes are applied to your codebase.

/siftcoder:preview

Shows proposed changes before applying

πŸ”’

Chroot Jail

Test changes in isolated environment before applying to real codebase.

/siftcoder:chroot

Creates isolated test environment

🎨 Skills vs Commands

Understanding the difference between commands and skills.

⚑ Commands (103)

What you type - Entry points for specific tasks

  • /siftcoder:build - Create new project
  • /siftcoder:fix - Fix bugs safely
  • /siftcoder:document - Generate docs

Commands orchestrate multiple skills and agents

🎯 Skills (22)

Reusable capabilities - Building blocks for workflows

  • Planning specialist
  • Code generator
  • Test runner
  • Documentation writer

Skills are invoked by commands to do specific work

πŸ”— Analogy

Commands are like restaurant orders ( "I want a meal" )

Skills are like kitchen techniques (chopping, grilling, plating)

Agents are like chefs who use techniques to fulfill orders

πŸ”„ Session & State Management

SiftCoder maintains context across your entire development session.

πŸ“ Session Memory

Remembers your preferences, previous commands, and project state

πŸ’Ύ Handoff Support

Pause work and resume later with full context preserved

πŸ”„ Checkpoints

Named restore points for safe experimentation

πŸ“Š Trace Viewing

See exactly what AI did and why (decision history)

☁️ Salesforce Specialization

SiftCoder includes 16+ specialized commands for Salesforce development.

⚑ Apex Development

  • Code analysis & bulkification
  • Enterprise pattern generation
  • Anti-pattern detection

⚑ Lightning Web Components

  • Component creation & testing
  • Wire adapter debugging
  • Performance analysis

πŸ—„οΈ Schema Management

  • Object & field creation
  • ERD diagram generation
  • Relationship mapping

πŸš€ Deployment

  • Validation & deployment
  • Org diff comparison
  • Rollback capabilities

What's Next?