Skip to main content

​
Dev Workflow

The Dev Workflow skill provides context injection for development workflow tasks, including atomic commits with task traceability, conventional commit messages, and systematic release processes.

​
Overview

PropertyValue
Skill IDct-dev-workflow
Tier2 (Execution)
Protocolcontribution
Tagsworkflow, git, release

​
Core Principle

CRITICAL: NO code changes or commits without a tracked task.
Every commit MUST be traceable to a CLEO task. This ensures:
  • Work is planned and tracked
  • Changes are reviewable and reversible
  • Progress is measurable
  • Context is preserved

​
Immutable Constraints

IDRuleEnforcement
WF-001Task requiredNO commits without CLEO task reference
WF-002Branch disciplineNO commits to main/master
WF-003Atomic commitsONE logical change per commit
WF-004Conventional format<type>(<scope>): <description>
WF-005Tests before pushRelevant tests MUST pass

​
Commit Message Format

<type>(<scope>): <description>

<body explaining why>

Task: T123
Co-Authored-By: Claude <noreply@anthropic.com>

​
Types

TypeDescriptionVersion Bump
featNew featureMINOR
fixBug fixPATCH
docsDocumentationNone
refactorCode restructurePATCH
testTest additionsNone
choreMaintenanceNone
perfPerformancePATCH
securitySecurity fixPATCH

​
Gate System

​
G0: Pre-Flight Check

# 1. Verify task context
cleo focus show

# 2. Check branch
git branch --show-current
# MUST NOT be main/master

# 3. Check uncommitted work
git status --porcelain

​
G1: Classify Change

Determine type based on change nature.

​
G2: Testing (Smart Scope)

Change TypeTest ScopeCommand
featRelated module testsbats tests/unit/feature.bats
fixRegression + affectedbats tests/unit/affected.bats
docsNoneSkip
refactorAffected modulesbats tests/unit/module*.bats
testNew tests onlybats tests/unit/new.bats
choreSyntax checkbash -n scripts/*.sh

​
G3: Commit

git add scripts/specific-file.sh
git commit -m "$(cat <<'EOF'
fix(auth): prevent token expiry race condition

Task: T1456
Co-Authored-By: Claude <noreply@anthropic.com>
EOF
)"

​
G4: Push (Triggers CI)

git push origin HEAD

​
G5: Version Bump (Release Only)

./dev/bump-version.sh patch
./dev/validate-version.sh
./install.sh --force

​
G6: Tag & Release

git tag -a v${VERSION} -m "${TYPE}: ${SUMMARY}"
git push origin v${VERSION}
git push origin HEAD

​
Complete Workflow Example

# 1. Verify task
cleo focus show
# Output: T1456 - Fix token validation

# 2. Make changes
# ... edit files ...

# 3. Run relevant test
bats tests/unit/auth.bats

# 4. Stage specific files
git add lib/auth.sh scripts/login.sh

# 5. Commit with task
git commit -m "$(cat <<'EOF'
fix(auth): prevent token expiry race condition

Task: T1456
Co-Authored-By: Claude <noreply@anthropic.com>
EOF
)"

# 6. Push
git push origin HEAD

# 7. Mark task complete
cleo complete T1456

​
Anti-Patterns

PatternProblemSolution
No task referenceUntracked workCreate/find task first
Committing to mainBypass reviewUse feature branches
Running full tests alwaysSlow iterationUse smart test scope
Giant commitsHard to review/revertAtomic commits