Skip to content

Commit 0837272

Browse files
author
Nick Sullivan
committed
Prettier formatting
1 parent 3c93757 commit 0837272

File tree

3 files changed

+50
-25
lines changed

3 files changed

+50
-25
lines changed

.claude/commands/autotask.md

Lines changed: 29 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -29,35 +29,41 @@ Read @rules/git-worktree-task.mdc for comprehensive autonomous workflow guidance
2929
<task-preparation>
3030
Analyze the task description to determine clarity:
3131

32-
**If unclear or ambiguous:** Use /create-prompt to ask clarifying questions and create a structured prompt. This ensures we capture all requirements upfront and saves time later. The /create-prompt workflow will:
32+
**If unclear or ambiguous:** Use /create-prompt to ask clarifying questions and create a
33+
structured prompt. This ensures we capture all requirements upfront and saves time
34+
later. The /create-prompt workflow will:
35+
3336
- Ask targeted clarification questions
3437
- Create a structured prompt document
3538
- Offer to execute immediately
3639

3740
**If clear and unambiguous:** Proceed directly to implementation.
3841

3942
Quick clarity check:
43+
4044
- Can you identify the exact files to modify? If no → use /create-prompt
4145
- Are there multiple valid approaches? If yes → use /create-prompt
42-
- Is the expected outcome measurable? If no → use /create-prompt
43-
</task-preparation>
46+
- Is the expected outcome measurable? If no → use /create-prompt </task-preparation>
4447

4548
<worktree-setup>
4649
Create an isolated development environment using /setup-environment:
4750

4851
Git worktree setup (auto-detected):
52+
4953
- Create worktree with branch
5054
- Run: /setup-environment
5155
- Automatically detects worktree context
5256
- Smoke test only (15-30 seconds)
5357
- Main repo already validated everything
5458

5559
The /setup-environment command is smart:
60+
5661
- Detects .gitworktrees/ path → minimal setup
5762
- Detects existing node_modules → minimal setup
5863
- Fresh clone without dependencies → full validation
5964

60-
No need to specify verification level - the command figures out the right approach based on context. Git worktrees get fast setup, new machines get thorough validation.
65+
No need to specify verification level - the command figures out the right approach based
66+
on context. Git worktrees get fast setup, new machines get thorough validation.
6167
</worktree-setup>
6268

6369
<autonomous-execution>
@@ -94,7 +100,8 @@ implementation decisions, constraint discoveries, and why choices were made.
94100
<obstacle-and-decision-handling>
95101
Pause only for deal-killers: security risks, data loss potential, or fundamentally unclear requirements. For everything else, make a reasonable choice and document it.
96102

97-
Design decisions get documented in the PR with rationale and alternatives considered. The executing model knows when to ask vs when to decide and document.
103+
Design decisions get documented in the PR with rationale and alternatives considered.
104+
The executing model knows when to ask vs when to decide and document.
98105
</obstacle-and-decision-handling>
99106

100107
<validation-and-review>
@@ -105,41 +112,48 @@ Design decisions get documented in the PR with rationale and alternatives consid
105112
- Fix only if hooks fail
106113

107114
**Targeted validation (complex features):**
115+
108116
- Run specific tests for changed code
109117
- Use Rivera for architecture review if patterns change
110118

111119
**Full validation (security/database/auth changes):**
120+
112121
- Comprehensive test suite
113122
- Multiple agent reviews
114123
- Security scanning
115124

116-
The principle: Don't duplicate what git hooks already do. They'll catch formatting, linting, and test failures at commit time. Only add extra validation when the risk justifies it.
117-
</validation-and-review>
125+
The principle: Don't duplicate what git hooks already do. They'll catch formatting,
126+
linting, and test failures at commit time. Only add extra validation when the risk
127+
justifies it. </validation-and-review>
118128

119129
<create-pr>
120130
Deliver a well-documented pull request ready for review, with commits following .cursor/rules/git-commit-message.mdc.
121131

122132
PR description must include:
123133

124134
Summary:
135+
125136
- What was implemented and why
126137
- How it addresses the requirements
127138

128139
Design Decisions (if any were made):
140+
129141
- List each significant decision with rationale
130142
- Note alternatives considered and trade-offs
131143
- Explain why each approach was chosen
132144

133145
Obstacles Encountered (if any):
146+
134147
- Document any challenges faced
135148
- How they were resolved or worked around
136149

137150
Testing:
151+
138152
- What validation was performed
139153
- Any edge cases considered
140154

141-
This transparency helps reviewers understand not just what changed, but why specific approaches were chosen and what was considered along the way.
142-
</create-pr>
155+
This transparency helps reviewers understand not just what changed, but why specific
156+
approaches were chosen and what was considered along the way. </create-pr>
143157

144158
<bot-feedback-loop>
145159
Autonomously address valuable bot feedback, reject what's not applicable, and deliver a PR ready for human review with all critical issues resolved.
@@ -161,19 +175,22 @@ times if needed until critical issues are resolved. </bot-feedback-loop>
161175
Provide a summary including:
162176

163177
What was accomplished:
178+
164179
- Core functionality delivered
165180
- Any design decisions made autonomously
166181
- Obstacles overcome without user intervention
167182

168183
Key highlights:
184+
169185
- Elegant solutions or optimizations
170186
- Significant issues found and fixed
171187
- Bot feedback addressed
172188

173-
Transparency note if applicable:
174-
"Made [N] design decisions autonomously - all documented in the PR for your review."
189+
Transparency note if applicable: "Made [N] design decisions autonomously - all
190+
documented in the PR for your review."
175191

176-
Include the PR URL and worktree location. Scale the summary length to complexity - simple tasks get brief summaries, complex features deserve detailed explanations.
192+
Include the PR URL and worktree location. Scale the summary length to complexity -
193+
simple tasks get brief summaries, complex features deserve detailed explanations.
177194
</completion>
178195

179196
<error-handling>

.claude/commands/setup-environment.md

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,8 @@ description: Initialize development environment for git worktree
44

55
# Setup Development Environment
66

7-
Initialize development environment with context-aware setup that distinguishes between git worktrees and new machines.
7+
Initialize development environment with context-aware setup that distinguishes between
8+
git worktrees and new machines.
89

910
<objective>
1011
Get the development environment ready for productive work, with right-sized verification based on context.
@@ -25,17 +26,18 @@ For git worktrees (15-30 seconds):
2526
- Trust main repo's validation
2627

2728
For new machines (2-5 minutes):
29+
2830
- Install and verify all dependencies
2931
- Set up and test git hooks
3032
- Run build process
3133
- Execute test suite
32-
- Verify all tools are available
33-
</setup-approach>
34+
- Verify all tools are available </setup-approach>
3435

3536
<project-detection>
3637
Identify the project type and package manager by examining project files:
3738

3839
Project types:
40+
3941
- Node.js: package.json present
4042
- Python: requirements.txt or Pipfile present
4143
- Ruby: Gemfile present
@@ -45,11 +47,11 @@ Project types:
4547
- .NET: .csproj files present
4648

4749
Package managers for Node.js:
50+
4851
- pnpm if pnpm-lock.yaml exists
4952
- yarn if yarn.lock exists
5053
- bun if bun.lockb exists
51-
- npm as default fallback
52-
</project-detection>
54+
- npm as default fallback </project-detection>
5355

5456
<dependency-installation>
5557
Install project dependencies using the appropriate package manager. For Node.js projects, use pnpm/yarn/bun/npm based on which lockfile exists. For Python, use pip or pipenv. Install with frozen/locked versions to ensure consistency with the main repository.
@@ -80,24 +82,24 @@ Run any necessary code generation steps the project requires:
8082
- TypeScript: Generate declarations if configured
8183
- Package prepare scripts: Run if defined in package.json
8284

83-
These ensure generated code is available for development.
84-
</code-generation>
85+
These ensure generated code is available for development. </code-generation>
8586

8687
<verification>
8788
Verify the environment is ready based on context:
8889

8990
For git worktrees (smoke test only):
91+
9092
- Confirm dependencies were installed successfully
9193
- Run a quick TypeScript compilation check if applicable
9294
- Trust that the main repository's validation is sufficient
9395

9496
For new machines (thorough verification):
97+
9598
- Verify all development tools are available and working
9699
- Run the build process to ensure it completes
97100
- Execute the test suite to confirm everything works
98101
- Test that git hooks function correctly
99-
- Check that all required command-line tools are installed
100-
</verification>
102+
- Check that all required command-line tools are installed </verification>
101103

102104
<error-handling>
103105
When encountering failures, identify the root cause and attempt automatic resolution where possible. For issues that require manual intervention, provide clear guidance on how to proceed. Continue with other setup steps when it's safe to do so without the failed component.
@@ -110,10 +112,11 @@ Git worktree success (15-30 seconds):
110112
- Development environment ready for immediate use
111113

112114
New machine success (2-5 minutes):
115+
113116
- All dependencies and tools functioning correctly
114117
- Build and test processes verified
115118
- Git hooks operational
116119
- Complete development environment validated
117120

118-
The goal is right-sized verification: minimal for worktrees that inherit from the main repository, comprehensive for new machine setups.
119-
</success-criteria>
121+
The goal is right-sized verification: minimal for worktrees that inherit from the main
122+
repository, comprehensive for new machine setups. </success-criteria>

.cursor/rules/prompt-engineering.mdc

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,9 @@ you create for LLM consumption.
2929

3030
## Key Principles for LLM-Readable Prompts
3131

32-
- Assume the executing model is smarter: The model executing your prompt is likely more capable than the model that created it. Trust its abilities rather than over-prescribing implementation details.
32+
- Assume the executing model is smarter: The model executing your prompt is likely more
33+
capable than the model that created it. Trust its abilities rather than
34+
over-prescribing implementation details.
3335
- Front-load critical information: LLMs give more weight to early content
3436
- Be explicit: LLMs can't infer context the way humans do
3537
- Maintain consistency: Use the same terminology throughout
@@ -143,7 +145,10 @@ what you don't want, even as a counterexample.
143145
When writing prompts for LLM execution (commands, workflows, agents), focus on clear
144146
outcomes rather than micro-managing steps. LLMs can figure out implementation details.
145147

146-
Remember: The model executing your prompt is likely more advanced than the model that created it. A prompt written by GPT-4 might be executed by Claude 3.5 Sonnet or GPT-4o. Even prompts written by older versions of the same model will be executed by newer, smarter versions. Trust the executing model's superior capabilities.
148+
Remember: The model executing your prompt is likely more advanced than the model that
149+
created it. A prompt written by GPT-4 might be executed by Claude 3.5 Sonnet or GPT-4o.
150+
Even prompts written by older versions of the same model will be executed by newer,
151+
smarter versions. Trust the executing model's superior capabilities.
147152

148153
### The Over-Prescription Problem in LLM-to-LLM Communication
149154

0 commit comments

Comments
 (0)