@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.
@@ -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 (MUST Follow)
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 NOT** overwhelm suggest max 3 options at a time
14
- 5. **MUST NOT** force workflows suggestions are optional, user can always say "no"
13
+ 4. **MUST** check `.agent/rules/skill-loading.md` before loading any skill
14
+ 5. **MUST NOT** overwhelmsuggest 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-v3.0-8B5CF6?style=for-the-badge&labelColor=1a1a2e" alt="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
- # Install everything
46
+ # npm
47
47
  npx @jhm1909/ag-kit init
48
48
 
49
- # Or pick a profile
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.0';
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/ directory always
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.0",
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
  ],