@jhm1909/ag-kit 0.1.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agent/rules/pre-commit-checklist.md +40 -0
- package/.agent/rules/workflow-advisor.md +5 -4
- package/.agent/templates/AGENTS.md +45 -0
- package/README.md +9 -3
- package/cli/index.js +11 -3
- package/package.json +2 -1
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
---
|
|
2
|
+
trigger: model_decision
|
|
3
|
+
description: Always apply when doing or writing testing
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Pre-Commit Checklist
|
|
7
|
+
|
|
8
|
+
> IMPORTANT: Run this checklist BEFORE every commit. Do not skip.
|
|
9
|
+
|
|
10
|
+
## Verification Steps
|
|
11
|
+
|
|
12
|
+
1. **Skill check**: Did you load the correct skill for this task?
|
|
13
|
+
- If unsure, re-read `.agent/rules/skill-loading.md`
|
|
14
|
+
|
|
15
|
+
2. **Workflow check**: Did you follow the workflow completely?
|
|
16
|
+
- If no workflow was used, state why explicitly
|
|
17
|
+
|
|
18
|
+
3. **Code quality**:
|
|
19
|
+
- [ ] No hardcoded secrets or API keys
|
|
20
|
+
- [ ] No `console.log` debugging left behind
|
|
21
|
+
- [ ] No commented-out code blocks
|
|
22
|
+
- [ ] No TODO without a linked issue
|
|
23
|
+
|
|
24
|
+
4. **Testing** (if code changed):
|
|
25
|
+
- [ ] Tests pass (`npm test` or equivalent)
|
|
26
|
+
- [ ] New code has test coverage
|
|
27
|
+
|
|
28
|
+
5. **Documentation** (if behavior changed):
|
|
29
|
+
- [ ] README or docs updated if user-facing behavior changed
|
|
30
|
+
- [ ] Code comments for non-obvious logic
|
|
31
|
+
|
|
32
|
+
6. **Git hygiene**:
|
|
33
|
+
- [ ] `.env` files are NOT staged
|
|
34
|
+
- [ ] `node_modules/` is NOT staged
|
|
35
|
+
- [ ] Commit message follows Conventional Commits format
|
|
36
|
+
|
|
37
|
+
## When to Skip
|
|
38
|
+
|
|
39
|
+
- Typo-only fixes (docs, comments)
|
|
40
|
+
- Dependency version bumps with no code changes
|
|
@@ -5,13 +5,14 @@ description: Always suggest relevant workflows when user starts a new task or se
|
|
|
5
5
|
|
|
6
6
|
# Workflow Advisor Rule
|
|
7
7
|
|
|
8
|
-
## Critical Rules (
|
|
8
|
+
## Critical Rules (MANDATORY)
|
|
9
9
|
|
|
10
|
-
1. **MUST** suggest relevant workflows when user describes a new project or task
|
|
10
|
+
1. **MUST** suggest relevant workflows when user describes a new project or task. This is not optional.
|
|
11
11
|
2. **MUST** suggest the *next* workflow when a current workflow completes
|
|
12
12
|
3. **MUST** present workflow chains for multi-phase projects, not individual commands
|
|
13
|
-
4. **MUST
|
|
14
|
-
5. **MUST NOT**
|
|
13
|
+
4. **MUST** check `.agent/rules/skill-loading.md` before loading any skill
|
|
14
|
+
5. **MUST NOT** overwhelm — suggest max 3 options at a time
|
|
15
|
+
6. **MUST NOT** skip workflow steps to be "faster" — follow the full workflow
|
|
15
16
|
|
|
16
17
|
## When to Activate
|
|
17
18
|
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
This project uses [Antigravity Kit](https://github.com/jhm1909/antigravity-kit) for AI agent configuration.
|
|
2
|
+
|
|
3
|
+
## Mandatory Rules
|
|
4
|
+
|
|
5
|
+
> IMPORTANT: You MUST follow these rules for EVERY task. No exceptions.
|
|
6
|
+
|
|
7
|
+
1. BEFORE any task: read `.agent/rules/skill-loading.md` to load the correct skill
|
|
8
|
+
2. BEFORE any commit: follow `.agent/workflows/commit.md` completely
|
|
9
|
+
3. BEFORE writing code: check `.agent/rules/clean-code.md` for standards
|
|
10
|
+
4. BEFORE writing tests: check `.agent/rules/testing.md` for requirements
|
|
11
|
+
5. BEFORE writing docs: check `.agent/rules/documents.md` for conventions
|
|
12
|
+
6. When starting a new task: suggest a workflow from `.agent/workflows/`
|
|
13
|
+
|
|
14
|
+
## Structure
|
|
15
|
+
|
|
16
|
+
All agent capabilities are in `.agent/`:
|
|
17
|
+
|
|
18
|
+
- `skills/` — 21 domain expert skills (frontend, backend, AI, security, design, etc.)
|
|
19
|
+
- `workflows/` — 15 chainable task workflows (brainstorm, implement, test, commit, etc.)
|
|
20
|
+
- `rules/` — 10 always-on coding standards and guardrails
|
|
21
|
+
- `skills-manifest.json` — Skill routing, triggers, and profiles
|
|
22
|
+
|
|
23
|
+
## How to Use
|
|
24
|
+
|
|
25
|
+
1. Read `.agent/skills-manifest.json` to understand available skills and their triggers
|
|
26
|
+
2. When starting a new task, check `.agent/workflows/guide.md` for workflow discovery
|
|
27
|
+
3. Skills are loaded on-demand — only read `SKILL.md` when the task matches a skill's triggers
|
|
28
|
+
4. Follow rules in `.agent/rules/` at all times
|
|
29
|
+
|
|
30
|
+
## Workflow Chains
|
|
31
|
+
|
|
32
|
+
```
|
|
33
|
+
New Project: /brainstorm -> /documentation -> /break-tasks -> /implement-feature -> /commit
|
|
34
|
+
New Feature: /break-tasks -> /implement-feature -> /gen-tests -> /commit
|
|
35
|
+
Bug Fix: /development -> /gen-tests -> /commit
|
|
36
|
+
Debug: /debug -> /commit
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Self-Verification
|
|
40
|
+
|
|
41
|
+
Before completing ANY task, verify:
|
|
42
|
+
- [ ] Loaded the correct skill for this task type
|
|
43
|
+
- [ ] Followed the workflow steps in order (did not skip steps)
|
|
44
|
+
- [ ] Applied relevant rules (testing, docs, git, clean-code)
|
|
45
|
+
- [ ] Code passes lint and tests
|
package/README.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="https://img.shields.io/badge/Antigravity_Kit-
|
|
2
|
+
<img src="https://img.shields.io/badge/Antigravity_Kit-v0.2.0-8B5CF6?style=for-the-badge&labelColor=1a1a2e" alt="Antigravity Kit" />
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
5
|
<h1 align="center">Antigravity Kit</h1>
|
|
@@ -43,11 +43,15 @@ Most AI coding assistants have **zero memory** between sessions. They forget you
|
|
|
43
43
|
## Quick Start
|
|
44
44
|
|
|
45
45
|
```bash
|
|
46
|
-
#
|
|
46
|
+
# npm
|
|
47
47
|
npx @jhm1909/ag-kit init
|
|
48
48
|
|
|
49
|
-
#
|
|
49
|
+
# pnpm
|
|
50
|
+
pnpm dlx @jhm1909/ag-kit init
|
|
51
|
+
|
|
52
|
+
# With a profile
|
|
50
53
|
npx @jhm1909/ag-kit init --profile fullstack-saas
|
|
54
|
+
pnpm dlx @jhm1909/ag-kit init --profile fullstack-saas
|
|
51
55
|
```
|
|
52
56
|
|
|
53
57
|
That's it. Your `.agent/` directory is now populated with skills, workflows, and rules.
|
|
@@ -153,6 +157,8 @@ Install only what you need:
|
|
|
153
157
|
|
|
154
158
|
```bash
|
|
155
159
|
npx @jhm1909/ag-kit init --profile <name>
|
|
160
|
+
# or
|
|
161
|
+
pnpm dlx @jhm1909/ag-kit init --profile <name>
|
|
156
162
|
```
|
|
157
163
|
|
|
158
164
|
| Profile | Included Skills | Optional |
|
package/cli/index.js
CHANGED
|
@@ -14,7 +14,7 @@ const fs = require('fs');
|
|
|
14
14
|
const path = require('path');
|
|
15
15
|
|
|
16
16
|
// ─── Constants ───────────────────────────────────────────────────────
|
|
17
|
-
const VERSION = '0.1
|
|
17
|
+
const VERSION = '0.2.1';
|
|
18
18
|
const KIT_NAME = '@jhm1909/ag-kit';
|
|
19
19
|
const AGENT_DIR = '.agent';
|
|
20
20
|
|
|
@@ -67,8 +67,8 @@ function copyDir(src, dest, allowedDirs = null, depth = 0) {
|
|
|
67
67
|
const srcPath = path.join(src, entry.name);
|
|
68
68
|
const destPath = path.join(dest, entry.name);
|
|
69
69
|
|
|
70
|
-
// Skip tmp/
|
|
71
|
-
if (entry.name === 'tmp') continue;
|
|
70
|
+
// Skip tmp/ and templates/ directories always
|
|
71
|
+
if (entry.name === 'tmp' || entry.name === 'templates') continue;
|
|
72
72
|
|
|
73
73
|
// At skills level (depth 1, parent is "skills"), filter by allowed dirs
|
|
74
74
|
if (depth === 1 && allowedDirs && entry.isDirectory()) {
|
|
@@ -181,6 +181,14 @@ function cmdInit(args) {
|
|
|
181
181
|
log(` ${c.cyan}|${c.reset} Workflows ${c.dim}Chainable task automations${c.reset}`);
|
|
182
182
|
log(` ${c.cyan}|${c.reset} Rules ${c.dim}Coding standards & guardrails${c.reset}`);
|
|
183
183
|
log(` ${c.cyan}|${c.reset} Manifest ${c.dim}Skill routing & profiles${c.reset}`);
|
|
184
|
+
// Copy AGENTS.md to project root for cross-platform discovery
|
|
185
|
+
const agentsMdSrc = path.join(SOURCE_AGENT_DIR, 'templates', 'AGENTS.md');
|
|
186
|
+
const agentsMdDest = path.join(targetDir, 'AGENTS.md');
|
|
187
|
+
if (fs.existsSync(agentsMdSrc) && (!fs.existsSync(agentsMdDest) || force)) {
|
|
188
|
+
fs.copyFileSync(agentsMdSrc, agentsMdDest);
|
|
189
|
+
success('Created AGENTS.md (cross-platform agent config)');
|
|
190
|
+
}
|
|
191
|
+
|
|
184
192
|
log();
|
|
185
193
|
log(`${c.dim} Works with: Claude Code, Cursor, Gemini CLI, GitHub Copilot${c.reset}`);
|
|
186
194
|
log();
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@jhm1909/ag-kit",
|
|
3
|
-
"version": "0.1
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "AI Agent Kit — 21 skills, 15 workflows, manifest-driven routing for AI-powered coding",
|
|
5
5
|
"main": "cli/index.js",
|
|
6
6
|
"bin": {
|
|
@@ -15,6 +15,7 @@
|
|
|
15
15
|
".agent/ARCHITECTURE.md",
|
|
16
16
|
".agent/known-registries.json",
|
|
17
17
|
".agent/mcp_config.json",
|
|
18
|
+
".agent/templates/",
|
|
18
19
|
"README.md",
|
|
19
20
|
"LICENSE"
|
|
20
21
|
],
|