@phuc1403/musketeer 0.8.0 → 0.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/INSTALLATION.md +52 -52
- package/README.md +49 -49
- package/bin/musketeer.js +168 -168
- package/manifest.json +333 -301
- package/package.json +48 -48
- package/src/dotnet-scaffold-copier.js +79 -79
- package/src/provisioner/detect.js +93 -93
- package/src/self-update.js +77 -77
- package/template/.claude/agents/code-reviewer.md +182 -166
- package/template/.claude/agents/git-manager.md +18 -18
- package/template/.claude/agents/hallmark-auditor.md +78 -78
- package/template/.claude/agents/researcher.md +33 -33
- package/template/.claude/hooks/block-unsafe-adr-title.cjs +85 -85
- package/template/.claude/hooks/git-skill-reminder.cjs +53 -0
- package/template/.claude/hooks/init-adr-dir.cjs +173 -173
- package/template/.claude/hooks/inject-adr-flags.cjs +94 -94
- package/template/.claude/hooks/lib/adr/command-scan.cjs +115 -115
- package/template/.claude/hooks/lib/characteristics/checker.cjs +357 -357
- package/template/.claude/hooks/lib/colors.cjs +180 -122
- package/template/.claude/hooks/lib/git-info-cache.cjs +191 -191
- package/template/.claude/hooks/lib/transcript-parser.cjs +300 -277
- package/template/.claude/hooks/sync-adr-toc.cjs +146 -146
- package/template/.claude/hooks/{usage-context-awareness.cjs → usage-quota-cache-refresh.cjs} +166 -166
- package/template/.claude/hooks/validate-characteristics-hook.cjs +66 -66
- package/template/.claude/hooks/validate-cml-hook.js +145 -145
- package/template/.claude/skills/adr-writer/SKILL.md +48 -48
- package/template/.claude/skills/adr-writer/references/adr-example.md +35 -35
- package/template/.claude/skills/architecture-characteristic-writer/SKILL.md +215 -215
- package/template/.claude/skills/architecture-characteristic-writer/assets/worksheet-template.md +29 -29
- package/template/.claude/skills/architecture-characteristic-writer/references/characteristics-catalog.md +40 -40
- package/template/.claude/skills/architecture-characteristic-writer/scripts/ranking-table.cjs +171 -171
- package/template/.claude/skills/code-review/SKILL.md +201 -54
- package/template/.claude/skills/code-review/references/checklist-workflow.md +96 -0
- package/template/.claude/skills/code-review/references/checklists/api.md +52 -52
- package/template/.claude/skills/code-review/references/checklists/base.md +100 -100
- package/template/.claude/skills/code-review/references/checklists/web-app.md +54 -54
- package/template/.claude/skills/code-review/references/code-review-reception.md +113 -0
- package/template/.claude/skills/code-review/references/codebase-scan-workflow.md +30 -0
- package/template/.claude/skills/code-review/references/edge-case-scouting.md +119 -0
- package/template/.claude/skills/code-review/references/input-mode-resolution.md +135 -0
- package/template/.claude/skills/code-review/references/parallel-review-workflow.md +76 -0
- package/template/.claude/skills/code-review/references/requesting-code-review.md +116 -0
- package/template/.claude/skills/code-review/references/spec-compliance-review.md +43 -0
- package/template/.claude/skills/code-review/references/task-management-reviews.md +140 -0
- package/template/.claude/skills/code-review/references/verification-before-completion.md +139 -0
- package/template/.claude/skills/context-map/SKILL.md +80 -80
- package/template/.claude/skills/context-map/example.cml +106 -106
- package/template/.claude/skills/context-map/reference/Bounded Context/Bounded Context.md +40 -40
- package/template/.claude/skills/context-map/reference/Bounded Context/businessModel.md +5 -5
- package/template/.claude/skills/context-map/reference/Bounded Context/domainVisionStatement.md +2 -2
- package/template/.claude/skills/context-map/reference/Bounded Context/evolution.md +5 -5
- package/template/.claude/skills/context-map/reference/Bounded Context/implementationTechnology.md +1 -1
- package/template/.claude/skills/context-map/reference/Bounded Context/implements.md +1 -1
- package/template/.claude/skills/context-map/reference/Bounded Context/knowledgeLevel.md +4 -4
- package/template/.claude/skills/context-map/reference/Bounded Context/realizes.md +9 -9
- package/template/.claude/skills/context-map/reference/Bounded Context/refines.md +10 -10
- package/template/.claude/skills/context-map/reference/Bounded Context/responsibilities.md +26 -26
- package/template/.claude/skills/context-map/reference/Bounded Context/type.md +23 -23
- package/template/.claude/skills/context-map/reference/Bounded Context Relationship/Anticorruption Layer.md +5 -5
- package/template/.claude/skills/context-map/reference/Bounded Context Relationship/Bounded Context Relationship.md +12 -12
- package/template/.claude/skills/context-map/reference/Bounded Context Relationship/Conformist.md +5 -5
- package/template/.claude/skills/context-map/reference/Bounded Context Relationship/Customer-Supplier (C-S).md +22 -22
- package/template/.claude/skills/context-map/reference/Bounded Context Relationship/Open Host Service.md +4 -4
- package/template/.claude/skills/context-map/reference/Bounded Context Relationship/Partnership (P).md +13 -13
- package/template/.claude/skills/context-map/reference/Bounded Context Relationship/Published Language.md +4 -4
- package/template/.claude/skills/context-map/reference/Bounded Context Relationship/Shared Kernel (SK).md +12 -12
- package/template/.claude/skills/context-map/reference/Context Map.md +62 -62
- package/template/.claude/skills/context-map/reference/Domain/Domain.md +30 -30
- package/template/.claude/skills/context-map/reference/Domain/supports.md +33 -33
- package/template/.claude/skills/context-map/reference/Domain/type.md +3 -3
- package/template/.claude/skills/context-map/reference/Semantic Rules.md +32 -32
- package/template/.claude/skills/git/SKILL.md +131 -115
- package/template/.claude/skills/git/references/branch-management.md +88 -88
- package/template/.claude/skills/git/references/commit-standards.md +46 -46
- package/template/.claude/skills/git/references/context-efficiency.md +54 -0
- package/template/.claude/skills/git/references/gh-cli-guide.md +109 -109
- package/template/.claude/skills/git/references/safety-protocols.md +69 -69
- package/template/.claude/skills/git/references/workflow-commit.md +58 -58
- package/template/.claude/skills/git/references/workflow-merge-pr.md +136 -0
- package/template/.claude/skills/git/references/workflow-merge.md +48 -48
- package/template/.claude/skills/git/references/workflow-pr.md +58 -58
- package/template/.claude/skills/git/references/workflow-push.md +52 -52
- package/template/.claude/skills/hallmark/SKILL.md +552 -552
- package/template/.claude/skills/hallmark/references/anti-patterns.md +412 -412
- package/template/.claude/skills/hallmark/references/assets.md +406 -406
- package/template/.claude/skills/hallmark/references/color.md +95 -95
- package/template/.claude/skills/hallmark/references/component-cookbook.md +256 -256
- package/template/.claude/skills/hallmark/references/components/c1-outlined-chip.md +12 -12
- package/template/.claude/skills/hallmark/references/components/c2-inline-form-as-cta.md +16 -16
- package/template/.claude/skills/hallmark/references/components/c3-typographic-link.md +8 -8
- package/template/.claude/skills/hallmark/references/components/c4-sticky-bottom-bar.md +16 -16
- package/template/.claude/skills/hallmark/references/components/f1-bento-grid.md +20 -20
- package/template/.claude/skills/hallmark/references/components/f2-sticky-scroll-stack.md +20 -20
- package/template/.claude/skills/hallmark/references/components/f3-tabular-spec-sheet.md +11 -11
- package/template/.claude/skills/hallmark/references/components/f4-step-sequence.md +11 -11
- package/template/.claude/skills/hallmark/references/components/f5-annotated-screenshot.md +11 -11
- package/template/.claude/skills/hallmark/references/components/f6-product-card-grid.md +41 -41
- package/template/.claude/skills/hallmark/references/components/ft1-mast-headed.md +13 -13
- package/template/.claude/skills/hallmark/references/components/ft2-inline-rule-single-line.md +10 -10
- package/template/.claude/skills/hallmark/references/components/ft3-index-style-category-list.md +12 -12
- package/template/.claude/skills/hallmark/references/components/ft4-dense-typographic.md +10 -10
- package/template/.claude/skills/hallmark/references/components/ft5-statement.md +21 -21
- package/template/.claude/skills/hallmark/references/components/ft6-letter-close.md +19 -19
- package/template/.claude/skills/hallmark/references/components/ft7-newsletter-first.md +27 -27
- package/template/.claude/skills/hallmark/references/components/ft8-marquee-scroll.md +25 -25
- package/template/.claude/skills/hallmark/references/components/h1-marquee.md +15 -15
- package/template/.claude/skills/hallmark/references/components/h2-split-diptych.md +15 -15
- package/template/.claude/skills/hallmark/references/components/h3-quote-led.md +11 -11
- package/template/.claude/skills/hallmark/references/components/h4-stat-led.md +14 -14
- package/template/.claude/skills/hallmark/references/components/h5-letter-hero.md +11 -11
- package/template/.claude/skills/hallmark/references/components/h6-photographic-fold.md +16 -16
- package/template/.claude/skills/hallmark/references/components/h7-demo-video-clipped-by-viewport-edge.md +27 -27
- package/template/.claude/skills/hallmark/references/components/h8-mockup-split-browser-framed.md +23 -23
- package/template/.claude/skills/hallmark/references/components/h9-custom-illustration-centerpiece.md +27 -27
- package/template/.claude/skills/hallmark/references/components/n1-wordmark-2-links.md +12 -12
- package/template/.claude/skills/hallmark/references/components/n10-floating-on-scroll-morph.md +19 -19
- package/template/.claude/skills/hallmark/references/components/n2-floating-chip.md +14 -14
- package/template/.claude/skills/hallmark/references/components/n3-side-rail.md +14 -14
- package/template/.claude/skills/hallmark/references/components/n4-hidden-behind-k.md +9 -9
- package/template/.claude/skills/hallmark/references/components/n5-floating-pill.md +28 -28
- package/template/.claude/skills/hallmark/references/components/n6-newspaper-masthead.md +24 -24
- package/template/.claude/skills/hallmark/references/components/n7-brutal-slab.md +22 -22
- package/template/.claude/skills/hallmark/references/components/n8-terminal-command.md +21 -21
- package/template/.claude/skills/hallmark/references/components/n9-edge-aligned-minimal.md +17 -17
- package/template/.claude/skills/hallmark/references/components/s1-left-margin-numbered.md +15 -15
- package/template/.claude/skills/hallmark/references/components/s2-hanging.md +13 -13
- package/template/.claude/skills/hallmark/references/components/s3-sticky-pinned.md +19 -19
- package/template/.claude/skills/hallmark/references/components/s4-inline-no-break.md +11 -11
- package/template/.claude/skills/hallmark/references/components/s5-bottom-anchored.md +13 -13
- package/template/.claude/skills/hallmark/references/components/t1-pull-quote-with-marginalia.md +12 -12
- package/template/.claude/skills/hallmark/references/components/t2-logo-wall-hairline.md +19 -19
- package/template/.claude/skills/hallmark/references/components/t3-single-huge-quote.md +11 -11
- package/template/.claude/skills/hallmark/references/components/t4-numbered-stat-strip.md +14 -14
- package/template/.claude/skills/hallmark/references/contract.md +24 -24
- package/template/.claude/skills/hallmark/references/copy.md +182 -182
- package/template/.claude/skills/hallmark/references/custom-craft.md +626 -626
- package/template/.claude/skills/hallmark/references/custom-theme.md +329 -329
- package/template/.claude/skills/hallmark/references/design-md.md +116 -116
- package/template/.claude/skills/hallmark/references/export-formats.md +328 -328
- package/template/.claude/skills/hallmark/references/floating-nav.md +89 -89
- package/template/.claude/skills/hallmark/references/genres/atmospheric.md +65 -65
- package/template/.claude/skills/hallmark/references/genres/editorial.md +70 -70
- package/template/.claude/skills/hallmark/references/genres/modern-minimal.md +67 -67
- package/template/.claude/skills/hallmark/references/genres/playful.md +65 -65
- package/template/.claude/skills/hallmark/references/hero-enrichment.md +474 -474
- package/template/.claude/skills/hallmark/references/imagery-kit.md +170 -170
- package/template/.claude/skills/hallmark/references/interaction-and-states.md +207 -207
- package/template/.claude/skills/hallmark/references/layout-and-space.md +111 -111
- package/template/.claude/skills/hallmark/references/macrostructures/01-bento-grid.md +35 -35
- package/template/.claude/skills/hallmark/references/macrostructures/02-long-document.md +34 -34
- package/template/.claude/skills/hallmark/references/macrostructures/03-marquee-hero.md +31 -31
- package/template/.claude/skills/hallmark/references/macrostructures/04-stat-led.md +32 -32
- package/template/.claude/skills/hallmark/references/macrostructures/05-workbench.md +32 -32
- package/template/.claude/skills/hallmark/references/macrostructures/06-conversational-faq.md +33 -33
- package/template/.claude/skills/hallmark/references/macrostructures/07-manifesto.md +32 -32
- package/template/.claude/skills/hallmark/references/macrostructures/08-photographic.md +34 -34
- package/template/.claude/skills/hallmark/references/macrostructures/09-quote-led.md +32 -32
- package/template/.claude/skills/hallmark/references/macrostructures/10-specimen.md +32 -32
- package/template/.claude/skills/hallmark/references/macrostructures/11-catalogue.md +23 -23
- package/template/.claude/skills/hallmark/references/macrostructures/12-letter.md +23 -23
- package/template/.claude/skills/hallmark/references/macrostructures/13-index-first.md +23 -23
- package/template/.claude/skills/hallmark/references/macrostructures/14-narrative-workflow.md +23 -23
- package/template/.claude/skills/hallmark/references/macrostructures/15-split-studio.md +23 -23
- package/template/.claude/skills/hallmark/references/macrostructures/16-feature-stack.md +23 -23
- package/template/.claude/skills/hallmark/references/macrostructures/17-type-specimen.md +23 -23
- package/template/.claude/skills/hallmark/references/macrostructures/18-portfolio-grid.md +23 -23
- package/template/.claude/skills/hallmark/references/macrostructures/19-map-diagram.md +23 -23
- package/template/.claude/skills/hallmark/references/macrostructures/20-ecosystem-index.md +23 -23
- package/template/.claude/skills/hallmark/references/macrostructures/21-component-playground.md +23 -23
- package/template/.claude/skills/hallmark/references/macrostructures.md +89 -89
- package/template/.claude/skills/hallmark/references/microinteractions.md +260 -260
- package/template/.claude/skills/hallmark/references/motion.md +109 -109
- package/template/.claude/skills/hallmark/references/preview-examples.md +49 -49
- package/template/.claude/skills/hallmark/references/responsive.md +138 -138
- package/template/.claude/skills/hallmark/references/slop-test.md +205 -205
- package/template/.claude/skills/hallmark/references/structure.md +164 -164
- package/template/.claude/skills/hallmark/references/study.md +511 -511
- package/template/.claude/skills/hallmark/references/typography.md +243 -243
- package/template/.claude/skills/hallmark/references/verbs/audit.md +25 -25
- package/template/.claude/skills/hallmark/references/verbs/redesign.md +269 -269
- package/template/.claude/skills/hallmark-loop/SKILL.md +105 -105
- package/template/.claude/skills/hallmark-loop/references/auditor-call.md +60 -60
- package/template/.claude/skills/hallmark-loop/references/capture.md +78 -78
- package/template/.claude/skills/hallmark-loop/references/loop-control.md +79 -79
- package/template/.claude/skills/handoff/SKILL.md +15 -15
- package/template/.claude/skills/knowledge-crunching/SKILL.md +94 -94
- package/template/.claude/skills/research/SKILL.md +69 -69
- package/template/.claude/skills/skill-creator/LICENSE.txt +201 -201
- package/template/.claude/skills/skill-creator/SKILL.md +154 -149
- package/template/.claude/skills/skill-creator/agents/analyzer.md +274 -274
- package/template/.claude/skills/skill-creator/agents/comparator.md +202 -202
- package/template/.claude/skills/skill-creator/agents/grader.md +223 -223
- package/template/.claude/skills/skill-creator/assets/eval_review.html +146 -146
- package/template/.claude/skills/skill-creator/eval-viewer/generate_review.py +471 -471
- package/template/.claude/skills/skill-creator/eval-viewer/viewer.html +1325 -1325
- package/template/.claude/skills/skill-creator/references/benchmark-optimization-guide.md +86 -86
- package/template/.claude/skills/skill-creator/references/distribution-guide.md +79 -79
- package/template/.claude/skills/skill-creator/references/eval-infrastructure-guide.md +129 -129
- package/template/.claude/skills/skill-creator/references/eval-schemas.md +121 -121
- package/template/.claude/skills/skill-creator/references/mcp-skills-integration.md +71 -71
- package/template/.claude/skills/skill-creator/references/metadata-quality-criteria.md +94 -94
- package/template/.claude/skills/skill-creator/references/plugin-marketplace-hosting.md +104 -104
- package/template/.claude/skills/skill-creator/references/plugin-marketplace-overview.md +89 -89
- package/template/.claude/skills/skill-creator/references/plugin-marketplace-schema.md +93 -93
- package/template/.claude/skills/skill-creator/references/plugin-marketplace-sources.md +103 -103
- package/template/.claude/skills/skill-creator/references/plugin-marketplace-troubleshooting.md +76 -76
- package/template/.claude/skills/skill-creator/references/script-quality-criteria.md +106 -106
- package/template/.claude/skills/skill-creator/references/skill-anatomy-and-requirements.md +77 -77
- package/template/.claude/skills/skill-creator/references/skill-creation-workflow.md +152 -151
- package/template/.claude/skills/skill-creator/references/skill-design-patterns.md +75 -75
- package/template/.claude/skills/skill-creator/references/skillmark-benchmark-criteria.md +102 -102
- package/template/.claude/skills/skill-creator/references/structure-organization-criteria.md +114 -114
- package/template/.claude/skills/skill-creator/references/testing-and-iteration.md +78 -78
- package/template/.claude/skills/skill-creator/references/token-efficiency-criteria.md +74 -74
- package/template/.claude/skills/skill-creator/references/troubleshooting-guide.md +81 -81
- package/template/.claude/skills/skill-creator/references/validation-checklist.md +83 -83
- package/template/.claude/skills/skill-creator/references/writing-effective-instructions.md +88 -88
- package/template/.claude/skills/skill-creator/references/yaml-frontmatter-reference.md +92 -92
- package/template/.claude/skills/skill-creator/scripts/aggregate_benchmark.py +401 -401
- package/template/.claude/skills/skill-creator/scripts/encoding_utils.py +36 -36
- package/template/.claude/skills/skill-creator/scripts/generate_report.py +326 -326
- package/template/.claude/skills/skill-creator/scripts/improve_description.py +248 -248
- package/template/.claude/skills/skill-creator/scripts/init_skill.py +360 -360
- package/template/.claude/skills/skill-creator/scripts/package_skill.py +143 -143
- package/template/.claude/skills/skill-creator/scripts/quick_validate.py +110 -110
- package/template/.claude/skills/skill-creator/scripts/run_eval.py +310 -310
- package/template/.claude/skills/skill-creator/scripts/run_loop.py +332 -332
- package/template/.claude/skills/skill-creator/scripts/utils.py +47 -47
- package/template/.claude/skills/tdd/SKILL.md +142 -142
- package/template/.claude/skills/tdd/deep-modules.md +15 -15
- package/template/.claude/skills/tdd/interface-design.md +31 -31
- package/template/.claude/skills/tdd/mocking.md +59 -59
- package/template/.claude/skills/tdd/refactoring.md +10 -10
- package/template/.claude/skills/tdd/tests.md +61 -61
- package/template/.claude/statusline.cjs +0 -0
- package/template/.claude/skills/code-review/references/adversarial-review.md +0 -223
|
@@ -1,48 +1,48 @@
|
|
|
1
|
-
# Merge Workflow
|
|
2
|
-
|
|
3
|
-
Execute via `git-manager` subagent.
|
|
4
|
-
|
|
5
|
-
## Variables
|
|
6
|
-
- TO_BRANCH: target (defaults to `main`)
|
|
7
|
-
- FROM_BRANCH: source (defaults to current branch)
|
|
8
|
-
|
|
9
|
-
## Step 1: Sync with Remote
|
|
10
|
-
|
|
11
|
-
**IMPORTANT: Always merge `main` (or any default branch) to current branch first.**
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
git fetch origin
|
|
15
|
-
git checkout {TO_BRANCH}
|
|
16
|
-
git pull origin {TO_BRANCH}
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
## Step 2: Merge from REMOTE
|
|
20
|
-
```bash
|
|
21
|
-
git merge origin/{FROM_BRANCH} --no-ff -m "merge: {FROM_BRANCH} into {TO_BRANCH}"
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
**Why `origin/{FROM_BRANCH}`:** Ensures merging only committed+pushed changes, not local WIP.
|
|
25
|
-
|
|
26
|
-
## Step 3: Resolve Conflicts
|
|
27
|
-
If conflicts:
|
|
28
|
-
1. Resolve manually
|
|
29
|
-
2. `git add . && git commit`
|
|
30
|
-
3. If clarifications needed, report to main agent
|
|
31
|
-
|
|
32
|
-
## Step 4: Push
|
|
33
|
-
```bash
|
|
34
|
-
git push origin {TO_BRANCH}
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
## Pre-Merge Checklist
|
|
38
|
-
- Fetch latest: `git fetch origin`
|
|
39
|
-
- Ensure FROM_BRANCH pushed to remote
|
|
40
|
-
- Check for conflicts: `git merge --no-commit --no-ff origin/{FROM_BRANCH}` then abort
|
|
41
|
-
|
|
42
|
-
## Error Handling
|
|
43
|
-
|
|
44
|
-
| Error | Action |
|
|
45
|
-
|-------|--------|
|
|
46
|
-
| Merge conflicts | Resolve manually, then commit |
|
|
47
|
-
| Branch not found | Verify branch name, ensure pushed |
|
|
48
|
-
| Push rejected | `git pull --rebase`, retry |
|
|
1
|
+
# Merge Workflow
|
|
2
|
+
|
|
3
|
+
Execute via `git-manager` subagent.
|
|
4
|
+
|
|
5
|
+
## Variables
|
|
6
|
+
- TO_BRANCH: target (defaults to `main`)
|
|
7
|
+
- FROM_BRANCH: source (defaults to current branch)
|
|
8
|
+
|
|
9
|
+
## Step 1: Sync with Remote
|
|
10
|
+
|
|
11
|
+
**IMPORTANT: Always merge `main` (or any default branch) to current branch first.**
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
git fetch origin
|
|
15
|
+
git checkout {TO_BRANCH}
|
|
16
|
+
git pull origin {TO_BRANCH}
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## Step 2: Merge from REMOTE
|
|
20
|
+
```bash
|
|
21
|
+
git merge origin/{FROM_BRANCH} --no-ff -m "merge: {FROM_BRANCH} into {TO_BRANCH}"
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
**Why `origin/{FROM_BRANCH}`:** Ensures merging only committed+pushed changes, not local WIP.
|
|
25
|
+
|
|
26
|
+
## Step 3: Resolve Conflicts
|
|
27
|
+
If conflicts:
|
|
28
|
+
1. Resolve manually
|
|
29
|
+
2. `git add . && git commit`
|
|
30
|
+
3. If clarifications needed, report to main agent
|
|
31
|
+
|
|
32
|
+
## Step 4: Push
|
|
33
|
+
```bash
|
|
34
|
+
git push origin {TO_BRANCH}
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## Pre-Merge Checklist
|
|
38
|
+
- Fetch latest: `git fetch origin`
|
|
39
|
+
- Ensure FROM_BRANCH pushed to remote
|
|
40
|
+
- Check for conflicts: `git merge --no-commit --no-ff origin/{FROM_BRANCH}` then abort
|
|
41
|
+
|
|
42
|
+
## Error Handling
|
|
43
|
+
|
|
44
|
+
| Error | Action |
|
|
45
|
+
|-------|--------|
|
|
46
|
+
| Merge conflicts | Resolve manually, then commit |
|
|
47
|
+
| Branch not found | Verify branch name, ensure pushed |
|
|
48
|
+
| Push rejected | `git pull --rebase`, retry |
|
|
@@ -1,58 +1,58 @@
|
|
|
1
|
-
# Pull Request Workflow
|
|
2
|
-
|
|
3
|
-
Execute via `git-manager` subagent.
|
|
4
|
-
|
|
5
|
-
## Variables
|
|
6
|
-
- TO_BRANCH: target (defaults to `main`)
|
|
7
|
-
- FROM_BRANCH: source (defaults to current branch)
|
|
8
|
-
|
|
9
|
-
## CRITICAL: Use REMOTE diff
|
|
10
|
-
PRs based on remote branches. Local diff includes unpushed changes.
|
|
11
|
-
|
|
12
|
-
## Tool 1: Sync + Analyze
|
|
13
|
-
|
|
14
|
-
**IMPORTANT: Always merge `main` (or any default branch) to current branch first.**
|
|
15
|
-
|
|
16
|
-
```bash
|
|
17
|
-
git fetch origin && \
|
|
18
|
-
git push -u origin HEAD 2>/dev/null || true && \
|
|
19
|
-
BASE=${BASE_BRANCH:-main} && \
|
|
20
|
-
HEAD=$(git rev-parse --abbrev-ref HEAD) && \
|
|
21
|
-
echo "=== PR: $HEAD → $BASE ===" && \
|
|
22
|
-
echo "=== COMMITS ===" && \
|
|
23
|
-
git log origin/$BASE...origin/$HEAD --oneline && \
|
|
24
|
-
echo "=== FILES ===" && \
|
|
25
|
-
git diff origin/$BASE...origin/$HEAD --stat
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
**If "Branch not on remote":** Push first, retry.
|
|
29
|
-
|
|
30
|
-
## Tool 2: Generate Content
|
|
31
|
-
**Title:** Conventional commit format, <72 chars, NO version numbers
|
|
32
|
-
**Body:** Summary bullets + Test plan checklist
|
|
33
|
-
|
|
34
|
-
## Tool 3: Create PR
|
|
35
|
-
```bash
|
|
36
|
-
gh pr create --base $BASE --head $HEAD --title "..." --body "$(cat <<'EOF'
|
|
37
|
-
## Summary
|
|
38
|
-
- Bullet points
|
|
39
|
-
|
|
40
|
-
## Test plan
|
|
41
|
-
- [ ] Test item
|
|
42
|
-
EOF
|
|
43
|
-
)"
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
## DO NOT use (local comparison)
|
|
47
|
-
- ❌ `git diff main...HEAD`
|
|
48
|
-
- ❌ `git diff --cached`
|
|
49
|
-
- ❌ `git status`
|
|
50
|
-
|
|
51
|
-
## Error Handling
|
|
52
|
-
|
|
53
|
-
| Error | Action |
|
|
54
|
-
|-------|--------|
|
|
55
|
-
| Branch not on remote | `git push -u origin HEAD`, retry |
|
|
56
|
-
| Empty diff | Warn: "No changes for PR" |
|
|
57
|
-
| Push rejected | `git pull --rebase`, resolve, push |
|
|
58
|
-
| No upstream | `git push -u origin HEAD` |
|
|
1
|
+
# Pull Request Workflow
|
|
2
|
+
|
|
3
|
+
Execute via `git-manager` subagent.
|
|
4
|
+
|
|
5
|
+
## Variables
|
|
6
|
+
- TO_BRANCH: target (defaults to `main`)
|
|
7
|
+
- FROM_BRANCH: source (defaults to current branch)
|
|
8
|
+
|
|
9
|
+
## CRITICAL: Use REMOTE diff
|
|
10
|
+
PRs based on remote branches. Local diff includes unpushed changes.
|
|
11
|
+
|
|
12
|
+
## Tool 1: Sync + Analyze
|
|
13
|
+
|
|
14
|
+
**IMPORTANT: Always merge `main` (or any default branch) to current branch first.**
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
git fetch origin && \
|
|
18
|
+
git push -u origin HEAD 2>/dev/null || true && \
|
|
19
|
+
BASE=${BASE_BRANCH:-main} && \
|
|
20
|
+
HEAD=$(git rev-parse --abbrev-ref HEAD) && \
|
|
21
|
+
echo "=== PR: $HEAD → $BASE ===" && \
|
|
22
|
+
echo "=== COMMITS ===" && \
|
|
23
|
+
git log origin/$BASE...origin/$HEAD --oneline && \
|
|
24
|
+
echo "=== FILES ===" && \
|
|
25
|
+
git diff origin/$BASE...origin/$HEAD --stat
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
**If "Branch not on remote":** Push first, retry.
|
|
29
|
+
|
|
30
|
+
## Tool 2: Generate Content
|
|
31
|
+
**Title:** Conventional commit format, <72 chars, NO version numbers
|
|
32
|
+
**Body:** Summary bullets + Test plan checklist
|
|
33
|
+
|
|
34
|
+
## Tool 3: Create PR
|
|
35
|
+
```bash
|
|
36
|
+
gh pr create --base $BASE --head $HEAD --title "..." --body "$(cat <<'EOF'
|
|
37
|
+
## Summary
|
|
38
|
+
- Bullet points
|
|
39
|
+
|
|
40
|
+
## Test plan
|
|
41
|
+
- [ ] Test item
|
|
42
|
+
EOF
|
|
43
|
+
)"
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## DO NOT use (local comparison)
|
|
47
|
+
- ❌ `git diff main...HEAD`
|
|
48
|
+
- ❌ `git diff --cached`
|
|
49
|
+
- ❌ `git status`
|
|
50
|
+
|
|
51
|
+
## Error Handling
|
|
52
|
+
|
|
53
|
+
| Error | Action |
|
|
54
|
+
|-------|--------|
|
|
55
|
+
| Branch not on remote | `git push -u origin HEAD`, retry |
|
|
56
|
+
| Empty diff | Warn: "No changes for PR" |
|
|
57
|
+
| Push rejected | `git pull --rebase`, resolve, push |
|
|
58
|
+
| No upstream | `git push -u origin HEAD` |
|
|
@@ -1,52 +1,52 @@
|
|
|
1
|
-
# Push Workflow
|
|
2
|
-
|
|
3
|
-
Execute via `git-manager` subagent.
|
|
4
|
-
|
|
5
|
-
## Pre-Push Checklist
|
|
6
|
-
1. All changes committed
|
|
7
|
-
2. Secrets scanned (see `safety-protocols.md`)
|
|
8
|
-
3. Branch pushed to remote
|
|
9
|
-
|
|
10
|
-
## Tool 1: Verify State
|
|
11
|
-
```bash
|
|
12
|
-
git status && \
|
|
13
|
-
git log origin/$(git rev-parse --abbrev-ref HEAD)..HEAD --oneline 2>/dev/null || echo "NO_UPSTREAM"
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
**If uncommitted changes:** Warn user, suggest commit first.
|
|
17
|
-
**If NO_UPSTREAM:** Use `git push -u origin HEAD`.
|
|
18
|
-
|
|
19
|
-
## Tool 2: Push
|
|
20
|
-
```bash
|
|
21
|
-
git push origin HEAD
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
**On success:** Report commit hashes pushed.
|
|
25
|
-
|
|
26
|
-
## Error Handling
|
|
27
|
-
|
|
28
|
-
| Error | Cause | Solution |
|
|
29
|
-
|-------|-------|----------|
|
|
30
|
-
| `rejected - non-fast-forward` | Remote has newer commits | `git pull --rebase`, resolve conflicts, push again |
|
|
31
|
-
| `no upstream branch` | Branch not tracked | `git push -u origin HEAD` |
|
|
32
|
-
| `Authentication failed` | Invalid credentials | Check `gh auth status` or SSH keys |
|
|
33
|
-
| `Repository not found` | Wrong remote URL | Verify `git remote -v` |
|
|
34
|
-
| `Permission denied` | No write access | Check repository permissions |
|
|
35
|
-
|
|
36
|
-
## Force Push (DANGER)
|
|
37
|
-
|
|
38
|
-
**NEVER force push to main/master/production branches.**
|
|
39
|
-
|
|
40
|
-
If user explicitly requests force push on feature branch:
|
|
41
|
-
```bash
|
|
42
|
-
git push -f origin HEAD
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
**Warn user:** "Force push rewrites history. Collaborators may lose work."
|
|
46
|
-
|
|
47
|
-
## Output Format
|
|
48
|
-
```
|
|
49
|
-
✓ pushed: N commits to origin/{branch}
|
|
50
|
-
- abc123 feat(auth): add login
|
|
51
|
-
- def456 fix(api): resolve timeout
|
|
52
|
-
```
|
|
1
|
+
# Push Workflow
|
|
2
|
+
|
|
3
|
+
Execute via `git-manager` subagent.
|
|
4
|
+
|
|
5
|
+
## Pre-Push Checklist
|
|
6
|
+
1. All changes committed
|
|
7
|
+
2. Secrets scanned (see `safety-protocols.md`)
|
|
8
|
+
3. Branch pushed to remote
|
|
9
|
+
|
|
10
|
+
## Tool 1: Verify State
|
|
11
|
+
```bash
|
|
12
|
+
git status && \
|
|
13
|
+
git log origin/$(git rev-parse --abbrev-ref HEAD)..HEAD --oneline 2>/dev/null || echo "NO_UPSTREAM"
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
**If uncommitted changes:** Warn user, suggest commit first.
|
|
17
|
+
**If NO_UPSTREAM:** Use `git push -u origin HEAD`.
|
|
18
|
+
|
|
19
|
+
## Tool 2: Push
|
|
20
|
+
```bash
|
|
21
|
+
git push origin HEAD
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
**On success:** Report commit hashes pushed.
|
|
25
|
+
|
|
26
|
+
## Error Handling
|
|
27
|
+
|
|
28
|
+
| Error | Cause | Solution |
|
|
29
|
+
|-------|-------|----------|
|
|
30
|
+
| `rejected - non-fast-forward` | Remote has newer commits | `git pull --rebase`, resolve conflicts, push again |
|
|
31
|
+
| `no upstream branch` | Branch not tracked | `git push -u origin HEAD` |
|
|
32
|
+
| `Authentication failed` | Invalid credentials | Check `gh auth status` or SSH keys |
|
|
33
|
+
| `Repository not found` | Wrong remote URL | Verify `git remote -v` |
|
|
34
|
+
| `Permission denied` | No write access | Check repository permissions |
|
|
35
|
+
|
|
36
|
+
## Force Push (DANGER)
|
|
37
|
+
|
|
38
|
+
**NEVER force push to main/master/production branches.**
|
|
39
|
+
|
|
40
|
+
If user explicitly requests force push on feature branch:
|
|
41
|
+
```bash
|
|
42
|
+
git push -f origin HEAD
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
**Warn user:** "Force push rewrites history. Collaborators may lose work."
|
|
46
|
+
|
|
47
|
+
## Output Format
|
|
48
|
+
```
|
|
49
|
+
✓ pushed: N commits to origin/{branch}
|
|
50
|
+
- abc123 feat(auth): add login
|
|
51
|
+
- def456 fix(api): resolve timeout
|
|
52
|
+
```
|