Skip to content

docs(skills): batch 2 skill follow-up enhancements#375

Merged
martincjarvis merged 8 commits intomainfrom
feat/skill-follow-up-batch-2
Jan 16, 2026
Merged

docs(skills): batch 2 skill follow-up enhancements#375
martincjarvis merged 8 commits intomainfrom
feat/skill-follow-up-batch-2

Conversation

@mcj-coder
Copy link
Owner

@mcj-coder mcj-coder commented Jan 16, 2026

Summary

  • Add practical examples, templates, checklists, and verification commands to 27 skills
  • Enhance skills with real-world usage patterns and CI integration examples
  • Update cspell.json dictionary for new technical terms
  • Restructure CLAUDE.md to consolidate team rules (docs: restructure CLAUDE.md to consolidate team rules #376)

Skills Enhanced

Batch 1 (from previous session)

Batch 2 (this session)

Test Plan

  • All markdown files pass markdownlint (evidence)
  • All files pass cspell dictionary check (evidence)
  • All files pass prettier formatting (evidence)
  • All files pass secretlint (no secrets detected) (evidence)

Closes #310, #311, #312, #315, #324, #327, #329, #330, #331, #332, #333, #335, #336, #337, #338, #339, #342, #344, #345, #346, #347, #349, #350, #351, #352, #354, #356, #376

🤖 Generated with Claude Code

…ld, testing, refactor

- dotnet-specification-pattern: Add spec examples and migration path (#327)
- dotnet-testing-assertions: Add migration checklist and assertion diff (#328)
- greenfield-baseline: Add stack-agnostic and prototype baselines (#330)
- testing-strategy-agnostic: Add minimal baseline template (#355)
- safe-brownfield-refactor: Add characterisation test template and checklist (#348)
- cspell: Add 'revertable', 'signup' to dictionary

Refs: #327, #328, #330, #348, #355
- technical-debt-prioritisation: Add worked scoring example and debt register (#353)
- quality-gate-enforcement: Add sample gate configs and coverage ratchet (#343)
- pair-programming: Add minimal pairing mode and handoff template (#340)

Refs: #340, #343, #353
- impacted-scope-enforcement: Add build tool commands and delta coverage (#331)
- incremental-change-impact: Add dependency tracing commands and template (#332)
- innersource-governance-bootstrap: Add compliance checklist and commands (#333)
- library-extraction-stabilisation: Add decision matrix and migration plan (#335)

Refs: #331, #332, #333, #335
…rvability

- local-dev-experience: Add baseline vs target worksheet and measurement script (#336)
- markdown-author: Add before/after examples and validation commands (#337)
- monorepo-orchestration-setup: Add nx/turbo evidence examples and metrics (#338)
- observability-logging-baseline: Add minimal validation checklist and commands (#339)

Refs: #336, #337, #338, #339
…ments

- process-skill-router: Add decision tree test matrix and sample prompts (#342)
- release-tagging-plan: Add sample tag commands and changelog linkage (#344)
- repo-best-practices-bootstrap: Add MVP bootstrap profile and checks (#345)
- requirements-gathering: Add question bank and validation checklist (#346)

Refs: #342, #344, #345, #346
…ls-first

- runtime-tooling-validation: Add command output examples and must-pass checklists (#347)
- scoped-colocation: Add sample directory layouts and audit checklist (#349)
- security-processes: Add minimal baseline security pipeline and templates (#350)
- skills-first-workflow: Add validation script and prerequisite commands (#351)

Refs: #347, #349, #350, #351
…trategy

- static-analysis-security: Add sample suppression entries and evidence capture guidance (#352)
- testcontainers-integration-tests: Add sample CI run logs and container lifecycle checklist (#354)
- testing-strategy-dotnet: Add example solution structure and sample CI matrix (#356)

Refs: #352, #354, #356
@github-actions
Copy link

github-actions bot commented Jan 16, 2026

Warnings
⚠️

[Issue] No plan comment found on linked issue. Post a plan comment with "## Plan" header or link to docs/plans/ before implementation. See Issue #177 for exemplar.

Messages
📖 All PR validation checks passed.

Generated by 🚫 dangerJS against 794bde7

- Add EXTREMELY-IMPORTANT skill invocation block at top
- Add comprehensive session initialization protocol
- Merge TDD/BDD enforcement details with examples
- Add complete 'Using Skills' guidance with flow diagram
- Add skill rationalizations table (red flags)
- Add persona-switching PR workflow (two-account pattern)
- Add session continuation protocol
- Add compliance checklists (before implementation/PR/merge)
- Add evidence requirements summary
- Update .gitignore to exclude CLAUDE.local.md

CLAUDE.local.md now contains only machine-specific configuration
(persona paths, account mappings, troubleshooting).

Closes #376
@mcj-coder
Copy link
Owner Author

Additional Commit

Added CLAUDE.md restructure commit:

What changed

Restructured CLAUDE.md and CLAUDE.local.md to properly separate concerns:

File Content Committed
CLAUDE.md All team/repo rules and process enforcement Yes
CLAUDE.local.md Machine-specific config only (paths, accounts) No (gitignored)

This ensures process enforcement rules are shared with the team while keeping machine-specific configuration local.

Copy link
Collaborator

@martincjarvis martincjarvis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM - All CI checks pass, evidence links provided, issue references included. 27 skills enhanced with practical examples, templates, and verification commands. CLAUDE.md restructured for team rules.

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 follow-up: broken-window

2 participants