Skip to content

Commit 1e57154

Browse files
committed
feat: add common-commands.md for bash commands section
- Create common-commands.md with project-specific commands - Add validation scripts, installation, and git commands - Update CLAUDE.md with link to new commands reference - Update conditional-loading.md with command patterns Closes #30
1 parent 764fa63 commit 1e57154

3 files changed

Lines changed: 43 additions & 2 deletions

File tree

project/CLAUDE.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ These guidelines define general conventions and practices for working in this re
2020
- [Question Handling](claude-guidelines/workflow.md)
2121
- [Problem Solving](claude-guidelines/problem-solving.md)
2222
- [Language Conventions](claude-guidelines/communication.md)
23+
- [Common Commands](claude-guidelines/common-commands.md)
2324

2425
</td>
2526
<td width="50%">
@@ -38,7 +39,7 @@ These guidelines define general conventions and practices for working in this re
3839

3940
| Category | Modules |
4041
|----------|---------|
41-
| **Environment & Workflow** | [Environment](claude-guidelines/environment.md), [Workflow](claude-guidelines/workflow.md), [Problem-Solving](claude-guidelines/problem-solving.md), [Communication](claude-guidelines/communication.md), [Git](claude-guidelines/git-commit-format.md) |
42+
| **Environment & Workflow** | [Environment](claude-guidelines/environment.md), [Workflow](claude-guidelines/workflow.md), [Problem-Solving](claude-guidelines/problem-solving.md), [Communication](claude-guidelines/communication.md), [Git](claude-guidelines/git-commit-format.md), [Commands](claude-guidelines/common-commands.md) |
4243
| **Code Standards** | [General](claude-guidelines/coding-standards/general.md), [Quality](claude-guidelines/coding-standards/quality.md), [Error Handling](claude-guidelines/coding-standards/error-handling.md), [Cleanup](claude-guidelines/operations/cleanup.md) |
4344
| **Technical** | [Concurrency](claude-guidelines/coding-standards/concurrency.md), [Memory](claude-guidelines/coding-standards/memory.md), [Performance](claude-guidelines/coding-standards/performance.md) |
4445
| **Project Management** | [Build](claude-guidelines/project-management/build.md), [Testing](claude-guidelines/project-management/testing.md), [Documentation](claude-guidelines/project-management/documentation.md) |
Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# Common Commands
2+
3+
> Quick reference for frequently used commands in this project
4+
5+
## Validation Scripts
6+
7+
- `./scripts/verify.sh`: Verify backup integrity and directory structure
8+
- `./scripts/validate_skills.sh`: Validate SKILL.md files for format compliance
9+
10+
## Installation & Deployment
11+
12+
- `./scripts/install.sh`: Install settings to system (~/.claude/ and project)
13+
- `./scripts/backup.sh`: Backup current system settings to repository
14+
- `./scripts/sync.sh`: Synchronize settings between system and backup
15+
16+
## Hook Management
17+
18+
- `./hooks/install-hooks.sh`: Install pre-commit hooks for SKILL.md validation
19+
20+
## Git Operations
21+
22+
- `git status`: Check working tree status
23+
- `git diff`: View unstaged changes
24+
- `git add . && git commit -m "message"`: Stage and commit changes
25+
- `git log --oneline -10`: View recent commit history
26+
27+
## GitHub CLI Commands
28+
29+
- `gh issue list --state open`: List open GitHub issues
30+
- `gh issue view <number>`: View specific issue details
31+
- `gh pr create --title "title" --body "body"`: Create pull request
32+
- `gh pr list`: List pull requests
33+
34+
## Quick Checks
35+
36+
- `wc -l project/CLAUDE.md`: Check CLAUDE.md line count
37+
- `find . -name "*.md" | wc -l`: Count markdown files in project

project/claude-guidelines/conditional-loading.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ Priority 4 (Optional): Load only if explicitly needed
9999
load: [documentation, communication]
100100

101101
/scripts/, /tools/:
102-
load: [general, error-handling]
102+
load: [common-commands, general, error-handling]
103103

104104
/src/api/, /routes/, /controllers/:
105105
load: [security, documentation, error-handling]
@@ -251,6 +251,9 @@ def determine_modules_to_load(context):
251251
| `issue label` | `github-issue-5w1h` | Labeling guidance |
252252
| `create PR` | `github-pr-5w1h`, `workflow` | PR creation |
253253
| `gh issue` | `github-issue-5w1h` | CLI command |
254+
| `run script` | `common-commands` | Script execution |
255+
| `install`, `backup`, `sync` | `common-commands` | Setup commands |
256+
| `validate`, `verify` | `common-commands` | Validation commands |
254257

255258
## 🔧 Override Mechanisms
256259

0 commit comments

Comments
 (0)