Skip to content

Conversation

@aRustyDev
Copy link
Owner

Summary

Adds comprehensive structured development workflow guidance to the k8s-helm-charts-dev skill, including workflow selection criteria, research/planning phases, and implementation best practices.

Changes

New Reference Files

  • references/extend-contribute-strategy.md - Fork vs copy-local decision tree, compatibility checklist, contribution workflow
  • references/research-phase-workflow.md - Structured research with approval gates
  • references/planning-phase-workflow.md - High-level planning, atomic components, phase plans, issue mapping
  • references/implementation-workflow.md - Draft PR pattern, sanity checks, external review stops

New Templates

  • assets/templates/research-summary.md - Research findings documentation template
  • assets/templates/high-level-plan.md - Overall chart planning template
  • assets/templates/phase-plan.md - Per-phase implementation plan template
  • assets/templates/issue-structure.md - Parent/child issue hierarchy with SemVer mapping

Updated Files

  • SKILL.md - Added "Structured Development Workflow" section with workflow selection table, updated Reference Files list
  • references/research-strategy.md - Added workflow selection criteria, expanded decision table

Motivation

This addresses gaps identified during Helm chart development:

  • No clear criteria for choosing Fast Path vs Full Workflow
  • Fork vs Copy-Local decision was incomplete
  • Templates content was vague
  • Approval gates were ambiguous
  • Issue mapping was too abstract

Testing

  • All files are valid markdown
  • References in SKILL.md point to existing files
  • Templates follow consistent structure

Checklist

  • Follows skill structure conventions
  • Uses progressive disclosure (brief in main file, detailed in references)
  • Templates are actionable and complete

Closes #816
Closes #696

🤖 Generated with Claude Code

Add Research → Planning → Implementation workflow with approval gates,
issue mapping, and extend/contribute strategy for complex Helm chart
development.

### Added

**Reference Files:**
- extend-contribute-strategy.md - Fork vs copy decision, contribution workflow
- research-phase-workflow.md - Structured research with approval gates
- planning-phase-workflow.md - High-level and phase planning with issue mapping
- implementation-workflow.md - Implementation with sanity checks and review stops
- research-strategy.md - Expanded decision table, workflow selection
- chart-complexity.md - Chart complexity classification
- external-services.md - Common ports, env vars, connection strings

**Templates:**
- research-summary.md - Research findings documentation
- high-level-plan.md - High-level chart plan
- phase-plan.md - Per-phase implementation plan
- issue-structure.md - GitHub issue hierarchy

**Patterns:**
- external-database.yaml - MySQL/PostgreSQL configuration
- external-search.yaml - Elasticsearch/OpenSearch configuration
- external-messaging.yaml - Airflow/Kafka/RabbitMQ/Redis configuration
- multi-port-service.yaml - Multiple ports pattern
- jvm-application.yaml - JVM heap/GC/JMX configuration
- health-probes-multiport.yaml - Probes on different ports

### Changed
- SKILL.md - Added "Structured Development Workflow" section
- SKILL.md - Updated Reference Files list

Closes #816
Closes #696

🤖 Generated with [Claude Code](https://claude.ai/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@aRustyDev aRustyDev merged commit 3875eeb into main Jan 16, 2026
4 checks passed
@aRustyDev aRustyDev deleted the feat/skill-k8s-helm-charts-dev-structured-workflow branch January 16, 2026 18:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[SKILL] Update k8s-helm-charts-dev with structured workflow review(skills): k8s-helm-charts-dev

2 participants