Skip to content

Commit 778771a

Browse files
authored
feat: import humanlayer commands/agents updates; remove jj specialization (#67)
1 parent 8547456 commit 778771a

18 files changed

+48
-170
lines changed

.claude/commands/import-humanlayer.md

Lines changed: 2 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -55,14 +55,6 @@ For each copied file (both commands and agents):
5555
---
5656
```
5757
- Convert the script's functionality into skill instructions within `SKILL.md`
58-
- If the script uses git-specific commands, include both git and jj (Jujutsu) equivalents in the skill instructions:
59-
```
60-
For git users:
61-
- <git command>
62-
63-
For jj users:
64-
- <jj equivalent>
65-
```
6658
- Replace the script reference in the original file with instructions to use the Skill tool
6759
3. Report which skills were created and which script references were replaced
6860

@@ -78,37 +70,15 @@ humanlayer/skills/
7870
- `description`: explains both what the skill does AND when it should be activated (max 1024 chars)
7971
- `allowed-tools` (optional): comma-separated list of tools the skill can use
8072
81-
### Step 5: Git/JJ Dual Support
82-
83-
For any agents that involve version control operations:
84-
85-
1. Identify git-specific commands (e.g., `git status`, `git commit`, `git branch`)
86-
2. Add equivalent jj commands alongside git commands
87-
3. Structure the instructions to support both workflows:
88-
```
89-
For git users:
90-
- <git command>
91-
92-
For jj users:
93-
- <jj equivalent>
94-
```
95-
4. Common conversions:
96-
- `git status` → `jj status`
97-
- `git branch` → `jj bookmark list`
98-
- `git commit` → `jj describe`
99-
- `git push` → `jj git push`
100-
- `git log` → `jj log`
101-
- `git diff` → `jj diff`
102-
103-
### Step 6: Validation
73+
### Step 5: Validation
10474
10575
1. Verify that all copied files are valid markdown
10676
2. Verify that all agent files have proper frontmatter with `name`, `description`, `tools`, and `model` fields
10777
3. Verify that all skill directories contain a valid `SKILL.md` with `name`, `description`, and optionally `allowed-tools` fields
10878
4. Check that no references to `thoughts sync` remain in any files
10979
5. Report any validation issues found
11080
111-
### Step 7: Summary Report
81+
### Step 6: Summary Report
11282
11383
Provide a comprehensive summary including:
11484
- Number of commands copied

humanlayer/commands/ci_commit.md

Lines changed: 5 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -10,31 +10,21 @@ You are tasked with creating git commits for the changes made during this sessio
1010

1111
1. **Think about what changed:**
1212
- Review the conversation history and understand what was accomplished
13-
- Check current changes:
14-
- For git users: `git status` and `git diff`
15-
- For jj users: `jj status` and `jj diff`
16-
- Consider whether changes should be one commit/change or multiple logical commits/changes
13+
- Run `git status` to see current changes
14+
- Run `git diff` to understand the modifications
15+
- Consider whether changes should be one commit or multiple logical commits
1716

1817
2. **Plan your commit(s):**
1918
- Identify which files belong together
2019
- Draft clear, descriptive commit messages
2120
- Use imperative mood in commit messages
2221
- Focus on why the changes were made, not just what
2322

24-
3. **Execute the commits:**
25-
26-
For git users:
23+
3. **Execute upon confirmation:**
2724
- Use `git add` with specific files (never use `-A` or `.`)
2825
- Never commit the `thoughts/` directory or anything inside it!
2926
- Never commit dummy files, test scripts, or other files which you created or which appear to have been created but which were not part of your changes or directly caused by them (e.g. generated code)
30-
- Create commits with your planned messages: `git commit -m "message"`
31-
32-
For jj users:
33-
- Changes are automatically tracked, no need to stage
34-
- Never include the `thoughts/` directory or anything inside it in your change description!
35-
- Never include dummy files, test scripts, or other files which you created or which appear to have been created but which were not part of your changes
36-
- Update the change description: `jj describe -m "message"`
37-
- If multiple changes needed, create new changes with `jj new` for each
27+
- Create commits with your planned messages until all of your changes are committed with `git commit -m`
3828

3929
## Remember:
4030
- You have the full context of what was done in this session

humanlayer/commands/ci_describe_pr.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,8 +55,9 @@ You are tasked with generating a comprehensive pull request description followin
5555
- Write a concise changelog entry
5656
- Ensure all checklist items are addressed (checked or explained)
5757

58-
8. **Save the description:**
58+
8. **Save and sync the description:**
5959
- Write the completed description to `thoughts/shared/prs/{number}_description.md`
60+
- Save the description to the thoughts directory
6061
- Show the user the generated description
6162

6263
9. **Update the PR:**

humanlayer/commands/commit.md

Lines changed: 5 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,9 @@ You are tasked with creating git commits for the changes made during this sessio
1010

1111
1. **Think about what changed:**
1212
- Review the conversation history and understand what was accomplished
13-
- Check current changes:
14-
- For git users: `git status` and `git diff`
15-
- For jj users: `jj status` and `jj diff`
16-
- Consider whether changes should be one commit/change or multiple logical commits/changes
13+
- Run `git status` to see current changes
14+
- Run `git diff` to understand the modifications
15+
- Consider whether changes should be one commit or multiple logical commits
1716

1817
2. **Plan your commit(s):**
1918
- Identify which files belong together
@@ -22,23 +21,15 @@ You are tasked with creating git commits for the changes made during this sessio
2221
- Focus on why the changes were made, not just what
2322

2423
3. **Present your plan to the user:**
25-
- List the files you plan to include for each commit/change
24+
- List the files you plan to add for each commit
2625
- Show the commit message(s) you'll use
2726
- Ask: "I plan to create [N] commit(s) with these changes. Shall I proceed?"
2827

2928
4. **Execute upon confirmation:**
30-
31-
For git users:
3229
- Use `git add` with specific files (never use `-A` or `.`)
33-
- Create commits with your planned messages: `git commit -m "message"`
30+
- Create commits with your planned messages
3431
- Show the result with `git log --oneline -n [number]`
3532

36-
For jj users:
37-
- Changes are automatically tracked, no need to stage
38-
- Update the change description: `jj describe -m "message"`
39-
- If multiple changes needed, create new changes: `jj new` for each
40-
- Show the result with `jj log -r 'ancestors(@, [number])'`
41-
4233
## Important:
4334
- **NEVER add co-author information or Claude attribution**
4435
- Commits should be authored solely by the user

humanlayer/commands/create_handoff.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Use the following information to understand how to create your document:
1616
- ENG-XXXX is the ticket number (replace with `general` if no ticket)
1717
- ENG-ZZZZ is the ticket number (omit if no ticket)
1818
- description is a brief kebab-case description
19-
- Use the Skill tool to gather metadata: invoke the "spec-metadata" skill
19+
- Use the **spec-metadata** skill to generate all relevant metadata
2020
- Examples:
2121
- With ticket: `2025-01-08_13-55-22_ENG-2166_create-context-compaction.md`
2222
- Without ticket: `2025-01-08_13-55-22_create-context-compaction.md`
@@ -65,7 +65,8 @@ type: implementation_strategy
6565
```
6666
---
6767

68-
### 3. Approve and Complete
68+
### 3. Present Result
69+
6970
Once this is completed, you should respond to the user with the template between <template_response></template_response> XML tags. do NOT include the tags in your response.
7071

7172
<template_response>

humanlayer/commands/create_plan.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -276,7 +276,7 @@ After structure approval:
276276
- Similar implementation: `[file:line]`
277277
````
278278

279-
### Step 5: Review
279+
### Step 5: Sync and Review
280280

281281
1. **Present the draft plan location**:
282282
```
@@ -295,7 +295,6 @@ After structure approval:
295295
- Adjust technical approach
296296
- Clarify success criteria (both automated and manual)
297297
- Add/remove scope items
298-
299298
4. **Continue refining** until the user is satisfied
300299

301300
## Important Guidelines

humanlayer/commands/create_plan_generic.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -275,7 +275,7 @@ After structure approval:
275275
- Similar implementation: `[file:line]`
276276
````
277277

278-
### Step 5: Review
278+
### Step 5: Sync and Review
279279

280280
1. **Present the draft plan location**:
281281
```

humanlayer/commands/create_worktree.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,10 @@
1+
12
---
23
description: Create worktree and launch implementation session for a plan
34
---
45

56
2. set up worktree for implementation:
6-
2a. Use the Skill tool to create a worktree: invoke the "create-worktree" skill with the Linear ticket number and branch name
7+
2a. use the **create-worktree** skill to create a new worktree with the Linear branch name (ENG-XXXX) and base branch
78

89
3. determine required data:
910

humanlayer/commands/debug.md

Lines changed: 7 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -46,11 +46,9 @@ You have access to these key locations and tools:
4646
- SQLite database with sessions, events, approvals, etc.
4747
- Can query directly with `sqlite3`
4848

49-
**Version Control State**:
49+
**Git State**:
5050
- Check current branch, recent commits, uncommitted changes
5151
- Similar to how `commit` and `describe_pr` commands work
52-
- For git users: Use `git status`, `git log`, `git diff`
53-
- For jj users: Use `jj status`, `jj log`, `jj diff`
5452

5553
**Service Status**:
5654
- Check if daemon is running: `ps aux | grep hld`
@@ -69,12 +67,8 @@ After the user describes the issue:
6967
- Identify expected vs actual behavior
7068

7169
2. **Quick state check**:
72-
- Current branch and recent commits:
73-
- For git users: `git branch --show-current` and `git log --oneline -5`
74-
- For jj users: `jj log -r @ --no-graph -T 'bookmarks'` and `jj log -r 'ancestors(@, 5)'`
75-
- Any uncommitted changes:
76-
- For git users: `git status` and `git diff`
77-
- For jj users: `jj status` and `jj diff`
70+
- Current git branch and recent commits
71+
- Any uncommitted changes
7872
- When the issue started occurring
7973

8074
### Step 2: Investigate the Issue
@@ -106,22 +100,14 @@ Return: Relevant database findings
106100
```
107101

108102
```
109-
Task 3 - Version Control and File State:
103+
Task 3 - Git and File State:
110104
Understand what changed recently:
111-
For git users:
112105
1. Check git status and current branch
113106
2. Look at recent commits: git log --oneline -10
114107
3. Check uncommitted changes: git diff
115-
116-
For jj users:
117-
1. Check jj status and current bookmarks
118-
2. Look at recent changes: jj log -r 'ancestors(@, 10)'
119-
3. Check uncommitted changes: jj diff
120-
121-
For both:
122108
4. Verify expected files exist
123109
5. Look for any file permission issues
124-
Return: Version control state and any file issues
110+
Return: Git state and any file issues
125111
```
126112

127113
### Step 3: Present Findings
@@ -146,7 +132,7 @@ Based on the investigation, present a focused debug report:
146132
[Finding from database]
147133
```
148134

149-
**From Version Control/Files**:
135+
**From Git/Files**:
150136
- [Recent changes that might be related]
151137
- [File state issues]
152138

@@ -204,20 +190,11 @@ ps aux | grep hld # Is daemon running?
204190
ps aux | grep wui # Is WUI running?
205191
```
206192

207-
**Version Control State**:
208-
209-
For git users:
193+
**Git State**:
210194
```bash
211195
git status
212196
git log --oneline -10
213197
git diff
214198
```
215199

216-
For jj users:
217-
```bash
218-
jj status
219-
jj log -r 'ancestors(@, 10)' --no-graph -T 'change_id.short() ++ " " ++ description.first_line() ++ "\n"'
220-
jj diff
221-
```
222-
223200
Remember: This command helps you investigate without burning the primary window's context. Perfect for when you hit an issue during manual testing and need to dig into logs, database, or git state.

humanlayer/commands/founder_mode.md

Lines changed: 10 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -7,32 +7,13 @@ you're working on an experimental feature that didn't get the proper ticketing a
77
assuming you just made a commit, here are the next steps:
88

99

10-
1. Get the commit identifier you just made (if you didn't make one, read `.claude/commands/commit.md` and make one):
11-
- For git users: Get the SHA with `git rev-parse HEAD`
12-
- For jj users: Get the change ID with `jj log -r @ --no-graph -T 'change_id.short()'`
13-
14-
2. Read `.claude/commands/linear.md` - think deeply about what you just implemented, then create a linear ticket about what you just did, and put it in 'in dev' state - it should have ### headers for "problem to solve" and "proposed solution"
15-
16-
3. Fetch the ticket to get the recommended branch name
17-
18-
4. Create a new branch from main with your changes:
19-
20-
For git users:
21-
```bash
22-
git checkout main
23-
git checkout -b 'BRANCHNAME'
24-
git cherry-pick 'COMMITHASH'
25-
git push -u origin 'BRANCHNAME'
26-
```
27-
28-
For jj users:
29-
```bash
30-
jj new main -m "description from ticket"
31-
jj squash --from 'CHANGEID' # Squash the experimental change into new change
32-
jj bookmark create BRANCHNAME
33-
jj git push --bookmark BRANCHNAME
34-
```
35-
36-
5. Create PR: `gh pr create --fill`
37-
38-
6. Read '.claude/commands/describe_pr.md' and follow the instructions
10+
1. get the sha of the commit you just made (if you didn't make one, read `.claude/commands/commit.md` and make one)
11+
12+
2. read `.claude/commands/linear.md` - think deeply about what you just implemented, then create a linear ticket about what you just did, and put it in 'in dev' state - it should have ### headers for "problem to solve" and "proposed solution"
13+
3. fetch the ticket to get the recommended git branch name
14+
4. git checkout main
15+
5. git checkout -b 'BRANCHNAME'
16+
6. git cherry-pick 'COMMITHASH'
17+
7. git push -u origin 'BRANCHNAME'
18+
8. gh pr create --fill
19+
9. read '.claude/commands/describe_pr.md' and follow the instructions

0 commit comments

Comments
 (0)