sdlc-rollout

SDLC Rollout

Track and drive SDLC rollout across Infiquetra organization repositories. Check rollout status, run gap analysis, deploy labels and templates, and update tracking records.

Script Location

$INFIQUETRA_SDLC_PATH/../infiquetra-claude-plugins/plugins/sdlc-manager/scripts/sdlc_manager.py

If $INFIQUETRA_SDLC_PATH is unset, use ~/workspace/infiquetra/infiquetra-sdlc as the default base path.

IMPORTANT: Always use python3 (not python) to run the script.

Rollout Status Overview

Rollout status is tracked in $INFIQUETRA_SDLC_PATH/config/rollout-status.json.

Repo Tiers

Tier	Priority	Description	Templates
Tier 1	High	Core service repos — full SDLC	All 6 templates
Tier 2	Medium	Infrastructure/shared repos — full SDLC	All 6 templates
Tier 3	Minimal	Claude tool repos — minimal SDLC only	defect + enhancement only

Team

Team	Project	Description
Mount Olympus	mount-olympus	All Infiquetra org repos

Note: Tier 3 repos (Claude tooling) are excluded from project board automation.

Rollout Tracking Fields

Each repo tracks four fields in rollout-status.json:

Field	Description	Complete when...
labels	SDLC labels deployed	All 40+ SDLC labels present in the repo
templates	Issue templates deployed	All required templates present (6 for Tier 1/2, 2 for Tier 3)
claude_md	CLAUDE.md has SDLC guidance section	CLAUDE.md exists with SDLC workflow guidance
project	Repo added to project board	Repo is linked to mount-olympus GitHub Project

Status values: pending, complete, n/a (for Tier 3 repos where project board is excluded)

Beads/Dolt Integration

Rollout tasks can be tracked in Beads for agent-driven coordination:

# Create a rollout task for a repo
bd ready sdlc-rollout-infiquetra-core

# An agent claims the rollout task
bd claim sdlc-rollout-infiquetra-core

# Agent completes the rollout
bd complete sdlc-rollout-infiquetra-core

When a Beads rollout task is completed, the corresponding rollout-status.json entry should be updated to reflect completion.

Core Operations

Rollout Status

# Status for all repos
python3 sdlc_manager.py rollout status

Output shows a table: repo, tier, and status of each tracking field.

Gap Analysis

# Check what a specific repo is missing
python3 sdlc_manager.py rollout gap-analysis --repo infiquetra-core
python3 sdlc_manager.py rollout gap-analysis --repo infiquetra-auth

Gap analysis checks:

1. Labels: Are all 40+ SDLC labels present? Lists any missing.
2. Templates: Are all required issue templates present? Lists missing template files.
3. Project: Is the repo linked to its project board?
4. CLAUDE.md: Does CLAUDE.md exist with an SDLC guidance section?

Deploy Labels

# Deploy (or update) all SDLC labels to a repo
python3 sdlc_manager.py rollout deploy-labels --repo infiquetra-core

Uses gh label create --force — creates new labels and updates existing ones. Safe to run multiple times (idempotent).

Deploy Templates

# Deploy all required issue templates to a repo
python3 sdlc_manager.py rollout deploy-templates --repo infiquetra-core

# Tier 3 repos get minimal templates (defect + enhancement only)
python3 sdlc_manager.py rollout deploy-templates --repo infiquetra-claude-plugins

Copies templates from infiquetra-sdlc checkout into .github/ISSUE_TEMPLATE/ in the target repo via GitHub API. Creates or updates template files.

Deploy All (Labels + Templates)

# Deploy labels and templates in one operation + show gap report
python3 sdlc_manager.py rollout deploy-all --repo infiquetra-core

Runs deploy-labels and deploy-templates in sequence, then produces a gap report showing what still needs attention (claude_md, project board mapping).

Update Tracking

# Mark a field as complete in rollout-status.json
python3 sdlc_manager.py rollout update --repo infiquetra-core --field labels --status complete
python3 sdlc_manager.py rollout update --repo infiquetra-core --field templates --status complete
python3 sdlc_manager.py rollout update --repo infiquetra-core --field claude_md --status complete
python3 sdlc_manager.py rollout update --repo infiquetra-core --field project --status complete

# Mark as n/a (for Tier 3 project field)
python3 sdlc_manager.py rollout update --repo infiquetra-claude-plugins --field project --status n/a

Always run rollout update after successful deployment to track progress.

Natural Language Examples

"How's the SDLC rollout going?" -> rollout status

"Which repos still need setup?" -> rollout status — look for any field that is not complete

"What's missing from infiquetra-auth?" -> rollout gap-analysis --repo infiquetra-auth

"Set up SDLC on infiquetra-core" -> rollout deploy-all --repo infiquetra-core, then update tracking fields

"Deploy labels to all Infiquetra repos" -> Run rollout deploy-labels for each repo

"Is infiquetra-core compliant?" -> rollout gap-analysis --repo infiquetra-core

"Mark infiquetra-core labels as done" -> rollout update --repo infiquetra-core --field labels --status complete

Deployment Workflow

Full Setup for a New Repo

# 1. Check current state
python3 sdlc_manager.py rollout gap-analysis --repo infiquetra-core

# 2. Deploy labels and templates
python3 sdlc_manager.py rollout deploy-all --repo infiquetra-core

# 3. Update tracking
python3 sdlc_manager.py rollout update --repo infiquetra-core --field labels --status complete
python3 sdlc_manager.py rollout update --repo infiquetra-core --field templates --status complete

# 4. Remaining steps (manual or via other commands):
#    - Add SDLC guidance section to CLAUDE.md -> update field claude_md
#    - Confirm repo is linked to project board -> update field project

Bulk Rollout

# Check status first
python3 sdlc_manager.py rollout status

# For each pending repo, run gap analysis then deploy
python3 sdlc_manager.py rollout gap-analysis --repo infiquetra-auth
python3 sdlc_manager.py rollout deploy-all --repo infiquetra-auth
python3 sdlc_manager.py rollout update --repo infiquetra-auth --field labels --status complete
python3 sdlc_manager.py rollout update --repo infiquetra-auth --field templates --status complete
# ... repeat for each repo

Verifying Existing Setup

# Run gap analysis to confirm all fields are present
python3 sdlc_manager.py rollout gap-analysis --repo infiquetra-core

# Check if rollout-status.json reflects current state
python3 sdlc_manager.py rollout status

If gap analysis finds nothing missing but rollout-status.json shows pending, run rollout update to sync the tracking record.

Special Cases

Tier 3 Repos (Claude Tooling)

• Deploy only defect and enhancement templates (not capability, objective, exploration, context-update)
• project field is n/a — these repos are excluded from project board automation
• Labels still apply (useful for tracking issues even without project board)

Reference Documents

• references/work-hierarchy.md — Initiative, Objective, Capability hierarchy reference
• $INFIQUETRA_SDLC_PATH/config/rollout-status.json — Live rollout tracking data
• $INFIQUETRA_SDLC_PATH/config/project-mappings.json — Repo-to-project mappings