dev/techpack.yaml at main · mcs-cli/dev · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
schemaVersion: 1
identifier: dev
displayName: "Dev Essentials"
description: Foundational settings, plugins, and git workflows for Claude Code
author: Bruno Guidolim
minMCSVersion: "2026.2.28"

# ---------------------------------------------------------------------------
# Prompts — resolved interactively during `mcs configure`
# ---------------------------------------------------------------------------
prompts:
  - key: BRANCH_PREFIX
    type: input
    label: "Branch prefix (e.g. feature) -> feature/add-login-screen"
    default: "feature"

# ---------------------------------------------------------------------------
# Components (short IDs — auto-prefixed by engine with `mcs-core-pack.`)
# ---------------------------------------------------------------------------
components:
  # ── Dependencies ────────────────────────────────────────────────────────
  - id: homebrew
    displayName: Homebrew
    description: macOS package manager
    type: brewPackage
    shell: '/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"'
    doctorChecks:
      - type: commandExists
        name: Homebrew
        section: Dependencies
        command: brew

  - id: node
    displayName: Node.js
    description: JavaScript runtime (for npx-based MCP servers)
    dependencies: [homebrew]
    brew: node

  - id: gh
    displayName: GitHub CLI
    description: GitHub CLI for PR operations
    dependencies: [homebrew]
    brew: gh

  - id: jq
    description: JSON processor (used by session hooks)
    dependencies: [homebrew]
    brew: jq

  # ── Plugins ─────────────────────────────────────────────────────────────
  - id: plugin-claude-md
    displayName: claude-md-management
    description: Audit and improve CLAUDE.md files across repositories
    plugin: "claude-md-management@claude-plugins-official"

  - id: plugin-claude-hud
    displayName: claude-hud
    description: Context usage, active tools, running agents, and todo progress
    plugin: claude-hud@jarrodwatts/claude-hud

  - id: plugin-pr-review-toolkit
    displayName: pr-review-toolkit
    description: Specialized review agents for comprehensive PR analysis
    plugin: "pr-review-toolkit@claude-plugins-official"

  # ── Hooks ───────────────────────────────────────────────────────────────
  - id: hook-session-start
    displayName: Session start hook
    description: Shows git status, branch protection, and open PRs on session start
    dependencies: [jq]
    hookEvent: SessionStart
    hook:
      source: hooks/session_start.sh
      destination: session_start.sh

  # ── Commands ────────────────────────────────────────────────────────────
  - id: command-commit
    displayName: /commit command
    description: Stages, commits, and pushes changes without PR creation
    command:
      source: commands/commit.md
      destination: commit.md

  - id: command-pr
    displayName: /pr command
    description: Automates stage, commit, push, and PR creation with ticket extraction
    dependencies: [gh]
    command:
      source: commands/pr.md
      destination: pr.md

  - id: command-review-pr
    displayName: /review-pr command
    description: Comprehensive PR review with context-aware specialized agents
    dependencies: [gh, plugin-pr-review-toolkit]
    command:
      source: commands/review-pr.md
      destination: review-pr.md

  # ── Configuration ───────────────────────────────────────────────────────
  - id: settings
    displayName: Settings
    description: Plan mode, always-thinking, env vars, hooks config, plugins
    settingsFile: config/settings.json

  - id: gitignore
    displayName: Global gitignore
    description: Core gitignore entries
    gitignore:
      - "*.local.*"

# ---------------------------------------------------------------------------
# Templates — CLAUDE.local.md sections
# ---------------------------------------------------------------------------
templates:
  - sectionIdentifier: git
    placeholders:
      - __BRANCH_PREFIX__
    contentFile: templates/git.md

# ---------------------------------------------------------------------------
# Supplementary doctor checks
# ---------------------------------------------------------------------------
supplementaryDoctorChecks:
  - type: hookEventExists
    name: SessionStart hook
    section: Hooks
    event: SessionStart