Skip to content

docs: Phase 2 - Skill Consolidation #381

@mcj-coder

Description

@mcj-coder

Summary

Reduce skill ambiguity and overlap by consolidating related skills and adding clarification documentation.

Scope

Logging Consolidation

  • Move dotnet-logging-serilog content to observability-logging-baseline/references/serilog-implementation.md
  • Add deprecation notice to original skill with redirect

Security Skills Clarification

  • Add decision matrix to security-processes skill
  • Add decision matrix to static-analysis-security skill
  • Add decision matrix to quality-gate-enforcement skill
  • Document: "Use X for [scope], Y for [scope], Z orchestrates both"

Bootstrapping Hierarchy

  • Document invocation order in greenfield-baseline
  • Document invocation order in repo-best-practices-bootstrap
  • Add cross-references and "Do NOT invoke if" clauses
  • Order: automated-standards → greenfield-baseline → repo-best-practices

Testing Strategy Decision Tree

  • Add decision tree to testing-strategy-agnostic
  • Guidance: agnostic → dotnet-specific → aspire OR testcontainers

Acceptance Criteria

  • Logging: Serilog content consolidated into observability skill with redirect
  • Security: All 3 skills have decision matrices showing when to use each
  • Bootstrapping: Clear hierarchy documented with cross-references
  • Testing: Decision tree guides users to correct testing skill
  • npm run lint passes with zero errors/warnings

Test Plan

  • Lint passes: npm run lint
  • All skill cross-references resolve correctly
  • Decision matrices are clear and actionable

Related

Part of Skills Repository Improvement Plan (Phase 2 of 4)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions