Skip to content

Add comprehensive SDLC framework: agents, templates, ADRs, standards - #486

Merged
Zordrak merged 1 commit into
masterfrom
chore/sdlc-improvements
Apr 24, 2026
Merged

Zordrak merged 1 commit into
masterfrom
chore/sdlc-improvements

Conversation

@Zordrak

@Zordrak Zordrak commented Apr 24, 2026

Copy link
Copy Markdown
Collaborator

Description

Comprehensive SDLC improvement modelled on the smarttriage agentic workflow, adapted for the tfenv bash project.

What is included

11 Specialist Agent Definitions (.github/agents/)

  • architect — ADRs, design decisions, trade-off analysis
  • bug-finder — Systematic codebase auditing, files structured issues
  • bug-fixer — TDD workflow: worktree, branch, test-first, fix, PR
  • developer — Autonomous orchestrator, dispatches specialists
  • documenter — Cross-doc consistency, link integrity
  • evaluator — Delivery metrics from gh data
  • feature-designer — Specs from ideas, writes acceptance criteria
  • feature-implementer — Builds from specs with tests
  • pm — Triage, planning, work selection
  • releaser — CHANGELOG, tags, GitHub releases
  • reviewer — Structured first-pass code review

Issue & PR Templates

  • Bug report YAML form with structured fields
  • Feature request YAML form with acceptance criteria
  • PR template with testing and quality checklists

AGENTS.md Overhaul

  • Worktree-first convention for multi-agent concurrency safety
  • Claim protocol (distributed lock via agent:in-progress label)
  • Work type ownership table mapping each type to its agent
  • Label taxonomy documentation
  • Satellite documentation index

Label Taxonomy (29 labels created via gh label)

  • type: bug, feature, chore, question
  • severity: critical, high, medium, low
  • priority: critical, high, medium, low
  • complexity: trivial, small, medium, large
  • confidence: confirmed, probable, speculative
  • category: install, use, list, uninstall, version-resolution, verification, platform, logging
  • agent: in-progress, review-requested

Architecture Decision Records

  • ADR template (0000-template.md)
  • ADR-0001: Use ADRs
  • ADR-0002: Standalone Script Execution
  • ADR-0003: No ShellCheck
  • ADR-0004: Agentic SDLC Workflow

Other

  • .github/copilot-instructions.md — auto-loading config
  • .github/instructions/bash.instructions.md — bash standards with applyTo
  • .github/CODEOWNERS — @Zordrak default
  • SECURITY.md — vulnerability reporting policy
  • .gitignore — .worktrees/ and .tmp/ for multi-agent safety
  • README.md prettified with badges, table of contents, contributing section

Testing

  • No code changes — documentation and configuration only
  • CI should pass (no functional changes)

Quality Checklist

  • All agent definitions follow consistent format
  • All cross-references verified
  • Label taxonomy created on GitHub
  • ADRs follow template format

@Zordrak Zordrak added the type:chore Maintenance, CI, docs, tooling label Apr 24, 2026
- Add 11 specialist agent definitions (.github/agents/)
  architect, bug-finder, bug-fixer, developer, documenter,
  evaluator, feature-designer, feature-implementer, pm, releaser, reviewer
- Add structured issue templates (bug-report, feature-request YAML forms)
- Add PR template with testing and quality checklists
- Add CODEOWNERS (default @Zordrak)
- Add SECURITY.md with vulnerability reporting policy
- Add .github/copilot-instructions.md pointing to AGENTS.md
- Add .github/instructions/bash.instructions.md with applyTo auto-loading
- Add ADR template and 4 seed ADRs (use-adrs, standalone-execution,
  no-shellcheck, agentic-sdlc-workflow)
- Overhaul AGENTS.md with worktree-first convention, claim protocol,
  work type ownership table, label taxonomy, satellite documentation
- Add namespaced label taxonomy (29 labels via gh CLI)
- Add .worktrees/ and .tmp/ to .gitignore for multi-agent safety
- Prettify README.md with badges, table of contents, contributing section
@Zordrak
Zordrak force-pushed the chore/sdlc-improvements branch from f6419b3 to 62a1eb4 Compare April 24, 2026 18:31
@Zordrak
Zordrak merged commit 6cb1206 into master Apr 24, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type:chore Maintenance, CI, docs, tooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant