Skip to content

Commit d3e6bc7

Browse files
feat(skills): require git and default to worktrees in the workflow skills
1 parent e533e1f commit d3e6bc7

6 files changed

Lines changed: 15 additions & 7 deletions

File tree

‎plugins/corbits-skills/skills/git-worktrees/SKILL.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ description: Create and tear down a worktree from origin/<default-branch>. Load
77

88
# git-worktrees
99

10-
How to create a worktree from origin/<default-branch> and tear it down. Load via `use_skill("git-worktrees")` and copy commands into a coder brief. The coder executes via `run_shell`. Do not run the git on the parent.
10+
Every workflow that writes code or checks out a branch works in a worktree, not the main checkout. Load this with `use_skill("git-worktrees")` and run the commands through `bash`.
1111

1212
## Create from origin/<default-branch>
1313

@@ -17,7 +17,7 @@ git fetch origin
1717
git worktree add ../worktree/<branch-name> -b <branch-name> origin/<default-branch>
1818
```
1919

20-
Always base new branches on `origin/<default-branch>` (whatever the repository uses). After creating the worktree, the coder `cd`s into it and installs local dependencies (`bun install` when the project uses Bun; otherwise follow developer docs). Worktrees do not share `node_modules`.
20+
Always base new branches on `origin/<default-branch>` (whatever the repository uses); a stacked branch bases on the previous branch instead. After creating the worktree, `cd` into it and install local dependencies (`bun install` when the project uses Bun; otherwise follow developer docs). Worktrees do not share `node_modules`.
2121

2222
## Teardown
2323

‎plugins/corbits-skills/skills/implement/SKILL.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,10 @@ description: Per-commit workflow with planner review, build gate, and reviewer l
77

88
A disciplined implementation workflow that produces reviewed, verified commits. Load this skill when you want each commit to go through architectural review, build verification, and code review before it lands.
99

10+
## Preflight
11+
12+
Requires a git repo. Run `git rev-parse --show-toplevel`; if it fails, stop and tell the operator to `git init` first. Work in a worktree from `origin/<default-branch>`, never in the main checkout: `use_skill("git-worktrees")` for the commands.
13+
1014
## Prerequisites
1115

1216
Before using this workflow, load the `style` and `philosophy` skills. Follow their conventions throughout.

‎plugins/corbits-skills/skills/native-integration/SKILL.md‎

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: native-integration
3-
description: Corbits rules for non-git folders, Linear status, tracker-agnostic issues, and posting reviews on GitHub
3+
description: Corbits rules for Linear status, tracker-agnostic issues, and posting reviews on GitHub
44
user-invocable: false
55
---
66

@@ -26,10 +26,6 @@ Move the issue to In Review when the PR is ready for review. Draft or WIP PRs st
2626

2727
`linear-issue-workflow` owns the full Linear ship loop.
2828

29-
## Non-git folders
30-
31-
A folder without `.git` is a valid working directory (scratch, unpacked tarball, new project). Git-using skills (`implement`, `review`, `pull-request`) no-op or ask when they need a repo. Do not invent a git repo to satisfy them.
32-
3329
## Tracker-agnostic issues
3430

3531
`/issue` is not Linear-only:

‎plugins/corbits-skills/skills/plan/SKILL.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ description: Author an eng change plan. Does not implement or file issues.
77

88
How to produce an engineering change plan. Does not implement. Does not file tracker issues.
99

10+
Requires a git repo. Run `git rev-parse --show-toplevel`; if it fails, stop and tell the operator to `git init` first.
11+
1012
If the change target is too fuzzy to plan, `ask_operator` first.
1113

1214
## What the plan must contain

‎plugins/corbits-skills/skills/refactor/SKILL.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,10 @@ description: Document a directory's design and plan improvements with the operat
88

99
Use this skill to analyze existing code, produce a structured design document, and collaboratively plan improvements for future implementation.
1010

11+
## Preflight
12+
13+
Requires a git repo. Run `git rev-parse --show-toplevel`; if it fails, stop and tell the operator to `git init` first. Work in a worktree from `origin/<default-branch>`, never in the main checkout: `use_skill("git-worktrees")` for the commands.
14+
1115
## Initialization
1216

1317
Before doing anything else, load the `philosophy` skill. The principles in that skill guide how you evaluate design decisions.

‎plugins/corbits-skills/skills/review/SKILL.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ description: Review a branch or pull request diff and report findings.
77

88
Use this skill when performing code reviews or pull request reviews.
99

10+
Requires a git repo. Run `git rev-parse --show-toplevel`; if it fails, stop and tell the operator to `git init` first.
11+
1012
## Classify, Then Recommend a Selected Fleet
1113

1214
First classify the review target, then recommend only the fleet the

0 commit comments

Comments
 (0)