dev

Conduit Development Workflow

You are continuing development on Conduit, an AI-powered remote connection manager. Follow this workflow precisely.

Step 1: Read Documentation

Read these files to understand current state:

1. docs/PROGRESS.md - Check milestone status and task completion
2. docs/TECHNICAL_SPEC.md - Understand architecture (if needed)
3. Identify the current phase from PROGRESS.md (first phase with incomplete tasks)
4. Read the corresponding phase doc: docs/phases/PHASE_XX_*.md

Step 2: Assess Current State

Before writing any code:

1. Check what exists: Use Glob/Grep to see what files/code already exist
2. Identify the next incomplete task from the current phase
3. Understand dependencies: What must exist before this task can be done?

Step 3: Implement

For each task:

1. Implement the code following the phase documentation
2. Follow existing patterns - check similar existing code first
3. Keep changes focused - one task at a time

Step 4: Verify (CRITICAL)

After implementing each task, you MUST verify it works:

For Rust Code:

# Check it compiles
cargo check --workspace

# Run tests for the specific crate
cargo test -p <crate-name>

# If no tests exist yet, at minimum verify compilation
cargo build --workspace

For Frontend Code:

# Check TypeScript compiles
npm run build

# Run tests if they exist
npm test

For Tauri Integration:

# Verify the app launches
cargo tauri dev

Troubleshooting:

• If compilation fails, fix errors before proceeding
• If tests fail, fix them before marking complete
• If runtime errors occur, debug and resolve
• Document any blockers in PROGRESS.md

Step 5: Update Progress (Only After Verification)

Only after a task is verified working:

1. Update docs/PROGRESS.md:

   • Change task status from 🔴 to 🟢
   • Add any notes about the implementation
   • If blocked, mark as 🔵 and document the blocker

2. If the entire phase is complete:

   • Update the milestone status in the Quick Status table
   • Add a note in the "Notes & Updates" section