coding-workflow

# coding-workflow

Document coding orchestration for Stage 2. Manages the systematic coding process, tracks progress, and generates audit trails.

## When to Use

Use this skill when:
- User is ready to start Stage 2 coding
- User asks about processing documents systematically
- User needs to track coding progress
- User wants to generate audit documentation
- User mentions "batch", "coding session", or "systematic coding"

## Prerequisites

**Before using this skill, verify:**
1. Stage 1 is complete (10+ documents manually coded)
2. Initial data structure exists
3. Project is properly initialized

Use `skills/_shared/scripts/read-config.js` to check readiness.

## Workflow Stages

### Stage 2 Phase 1: Parallel Streams

**Stream A (Theoretical)**
- Analyze foundational literature
- Extract theoretical patterns
- Use @scholarly-companion for Socratic dialogue

**Stream B (Empirical)**
- Apply @dialogical-coder to documents
- Follow 4-stage visible reasoning
- Build evidence for concepts

### Stage 2 Phase 2: Synthesis

- Compare theoretical and empirical patterns
- Identify alignments and tensions
- Refine data structure

### Stage 2 Phase 3: Pattern Characterization

- Identify systematic variations
- Document pattern properties
- Prepare for Stage 3 theorizing

## Scripts

### process-batch.js
Process a batch of documents through coding workflow.

```bash
node skills/coding-workflow/scripts/process-batch.js \
  --project-path /path/to/project \
  --documents "D001,D002,D003" \
  --agent dialogical-coder \
  --phase phase2_synthesis
```

### track-documents.js
Track which documents have been coded and their status.

```bash
node skills/coding-workflow/scripts/track-documents.js \
  --project-path /path/to/project \
  --list  # List all documents and status
  --mark-coded D004  # Mark document as coded
```

### generate-audit.js
Generate audit trail documentation.

```bash
node skills/coding-workflow/scripts/generate-audit.js \
  --project-path /path/to/project \
  -