Skip to content

Commit affc463

Browse files
committed
Clean up unused
1 parent 1901831 commit affc463

File tree

17 files changed

+252
-584
lines changed

17 files changed

+252
-584
lines changed

.agent/skills/dev-lifecycle

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
/Users/hoangnguyen/.ai-devkit/skills/codeaholicguy/ai-devkit/skills/dev-lifecycle

.agents/skills/debug/SKILL.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
name: debug
3+
description: Guide structured debugging before code changes by clarifying expected behavior, reproducing issues, identifying likely root causes, and agreeing on a fix plan with validation steps. Use when users ask to debug bugs, investigate regressions, triage incidents, diagnose failing behavior, handle failing tests, analyze production incidents, investigate error spikes, or run root cause analysis (RCA).
4+
---
5+
6+
# Local Debugging Assistant
7+
8+
Debug with an evidence-first workflow before changing code.
9+
10+
## Hard Rule
11+
- Do not modify code until the user approves a selected fix plan.
12+
13+
## Workflow
14+
15+
1. Clarify
16+
- Restate observed vs expected behavior in one concise diff.
17+
- Confirm scope and measurable success criteria.
18+
19+
2. Reproduce
20+
- Capture minimal reproduction steps.
21+
- Capture environment fingerprint: runtime, versions, config flags, data sample, and platform.
22+
23+
3. Hypothesize and Test
24+
For each hypothesis, include:
25+
- Predicted evidence if true.
26+
- Disconfirming evidence if false.
27+
- Exact test command or check.
28+
- Prefer one-variable-at-a-time tests.
29+
30+
4. Plan
31+
- Present fix options with risks and verification steps.
32+
- Recommend one option and request approval.
33+
34+
## Validation
35+
- Confirm a pre-fix failing signal exists.
36+
- Confirm post-fix success and run nearby regression checks.
37+
- Summarize remaining risks and follow-ups.
38+
39+
## Output Template
40+
Use this response structure:
41+
- Observed vs Expected
42+
- Repro and Environment
43+
- Hypotheses and Tests
44+
- Options and Recommendation
45+
- Validation Plan and Results
46+
- Open Questions
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
interface:
2+
display_name: "Debug Assistant"
3+
short_description: "Guide structured debugging before code changes"
4+
default_prompt: "Use $debug to investigate this issue step by step, produce fix options with risks and validation steps, and wait for confirmation before changing code."

.agents/skills/dev-lifecycle

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
/Users/hoangnguyen/.ai-devkit/skills/codeaholicguy/ai-devkit/skills/dev-lifecycle

.agents/skills/memory/SKILL.md

Lines changed: 200 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,200 @@
1+
---
2+
name: memory
3+
description: Use AI DevKit's memory service to store and retrieve knowledge via CLI commands instead of MCP.
4+
---
5+
6+
# AI DevKit Memory Skill
7+
8+
This skill teaches you how to use AI DevKit's **Memory** service through CLI commands. Memory allows you to store actionable insights, coding patterns, and project guidelines that persist across sessions.
9+
10+
## When to Use This Skill
11+
12+
Use the memory CLI commands when:
13+
- MCP (Model Context Protocol) is not available or not configured
14+
- You need to store knowledge directly from the terminal
15+
- You want to search for previously stored patterns or guidelines
16+
- You're scripting memory operations
17+
18+
## Prerequisites
19+
20+
Ensure AI DevKit CLI is available:
21+
```bash
22+
npx ai-devkit --version
23+
```
24+
25+
## Commands Reference
26+
27+
### Storing Knowledge
28+
29+
Store new knowledge items using the `memory store` command:
30+
31+
```bash
32+
npx ai-devkit memory store \
33+
--title "<short descriptive title>" \
34+
--content "<detailed knowledge content>" \
35+
--tags "<comma-separated tags>" \
36+
--scope "<scope>"
37+
```
38+
39+
**Parameters:**
40+
41+
| Parameter | Required | Description |
42+
|-------------|----------|-------------|
43+
| `--title` | Yes | Short, descriptive title (5-12 words, 10-100 chars) |
44+
| `--content` | Yes | Detailed explanation in markdown format (50-5000 chars) |
45+
| `--tags` | No | Comma-separated domain keywords (e.g., `typescript,react`) |
46+
| `--scope` | No | `global` (default), `project:<name>`, or `repo:<org/repo>` |
47+
48+
**Examples:**
49+
50+
```bash
51+
# Store a global coding pattern
52+
npx ai-devkit memory store \
53+
--title "Always handle BigInt serialization in API responses" \
54+
--content "When returning BigInt values from API endpoints, convert them to strings using \`BigInt.toString()\` before serialization. JSON.stringify() cannot serialize BigInt natively." \
55+
--tags "api,backend,serialization" \
56+
--scope "global"
57+
58+
# Store project-specific knowledge
59+
npx ai-devkit memory store \
60+
--title "Use pnpm for package management" \
61+
--content "This monorepo uses pnpm workspaces. Always use 'pnpm' instead of 'npm' or 'yarn'. Install dependencies with 'pnpm install' and run scripts with 'pnpm run <script>'." \
62+
--scope "project:my-monorepo"
63+
64+
# Store repository-specific rules
65+
npx ai-devkit memory store \
66+
--title "Database migrations require review" \
67+
--content "All database schema changes must be reviewed by the DBA team before merging. Create migration files in /migrations and tag the PR with 'needs-dba-review'." \
68+
--tags "database,migrations,process" \
69+
--scope "repo:myorg/backend-api"
70+
```
71+
72+
### Searching Knowledge
73+
74+
Search for stored knowledge using the `memory search` command:
75+
76+
```bash
77+
npx ai-devkit memory search --query "<search query>"
78+
```
79+
80+
**Parameters:**
81+
82+
| Parameter | Required | Description |
83+
|-----------|----------|-------------|
84+
| `--query` | Yes | Natural language search query (3-500 chars) |
85+
| `--tags` | No | Comma-separated tags to boost matching (e.g., `api,backend`) |
86+
| `--scope` | No | Filter by scope (results from matching scope are prioritized) |
87+
| `--limit` | No | Maximum results to return (1-20, default: 5) |
88+
89+
**Example:**
90+
91+
```bash
92+
# Basic search
93+
npx ai-devkit memory search --query "API response handling"
94+
95+
# Search with tag boosting
96+
npx ai-devkit memory search \
97+
--query "docker configuration" \
98+
--tags "docker,infra"
99+
100+
# Search within a specific scope
101+
npx ai-devkit memory search \
102+
--query "coding standards" \
103+
--scope "project:my-app" \
104+
--limit 10
105+
```
106+
107+
**Output Format:**
108+
109+
The search command returns JSON with ranked results:
110+
111+
```json
112+
{
113+
"results": [
114+
{
115+
"id": "uuid-string",
116+
"title": "Knowledge title",
117+
"content": "Detailed content...",
118+
"tags": ["tag1", "tag2"],
119+
"scope": "global",
120+
"score": 5.2
121+
}
122+
],
123+
"totalMatches": 1,
124+
"query": "your search query"
125+
}
126+
```
127+
128+
## Best Practices
129+
130+
### Crafting Good Titles
131+
- Be explicit and actionable: "Always validate user input before database queries"
132+
- Include the domain: "React: Use useCallback for event handlers in list items"
133+
- Keep it concise: 5-12 words that capture the essence
134+
135+
### Writing Effective Content
136+
- Use markdown for formatting
137+
- Include code examples when applicable
138+
- Explain the "why" not just the "what"
139+
- Add edge cases and exceptions
140+
141+
### Using Tags Effectively
142+
- Use lowercase, single-word tags
143+
- Include technology names: `typescript`, `react`, `docker`
144+
- Include domains: `api`, `frontend`, `testing`, `security`
145+
- Include action types: `debugging`, `performance`, `patterns`
146+
147+
### Choosing the Right Scope
148+
149+
| Scope | Use When |
150+
|-------|----------|
151+
| `global` | Knowledge applies to all your projects |
152+
| `project:<name>` | Specific to a named project |
153+
| `repo:<org/repo>` | Specific to a git repository |
154+
155+
## Integration with AI Workflows
156+
157+
When storing knowledge during a conversation:
158+
159+
1. **Before storing**, search to avoid duplicates:
160+
```bash
161+
npx ai-devkit memory search --query "similar topic"
162+
```
163+
164+
2. **After resolving an issue**, store the solution:
165+
```bash
166+
npx ai-devkit memory store \
167+
--title "Fix: Issue description" \
168+
--content "Solution details with code examples..." \
169+
--tags "relevant,tags"
170+
```
171+
172+
3. **Before starting a task**, search for relevant context:
173+
```bash
174+
npx ai-devkit memory search --query "task description"
175+
```
176+
177+
## Storage Location
178+
179+
All memory data is stored locally at:
180+
```
181+
~/.ai-devkit/memory.db
182+
```
183+
184+
This SQLite database is portable—copy it to another machine to share knowledge.
185+
186+
## Troubleshooting
187+
188+
### "Duplicate title" error
189+
A knowledge item with a similar title already exists in that scope. Either:
190+
- Use a more specific title
191+
- Update the existing entry (delete and re-add)
192+
- Use a different scope
193+
194+
### "Query too short" error
195+
Search queries must be at least 3 characters. Provide more context in your search.
196+
197+
### Empty search results
198+
- Broaden your search terms
199+
- Remove tag filters
200+
- Try different keyword variations

.claude/skills/dev-lifecycle/SKILL.md

Lines changed: 0 additions & 67 deletions
This file was deleted.

.claude/skills/dev-lifecycle/references/check-implementation.md

Lines changed: 0 additions & 35 deletions
This file was deleted.

0 commit comments

Comments
 (0)