pikakit 3.9.130 β†’ 3.9.131

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/README.md CHANGED
@@ -1,373 +1,173 @@
1
1
  <div align="center">
2
2
 
3
- # πŸ€– PikaKit β€” FAANG-Grade AI Operating System
3
+ # πŸ€– PikaKit
4
+ ### The AI Operating System for Production-Grade Development
4
5
 
5
- ### Transform your AI Agent into a FAANG-level engineering team
6
+ Build production-grade features 3–5x faster β€” with enforced architecture, autonomous workflows, and a self-learning AI that never repeats mistakes.
6
7
 
7
- [![npm version](https://img.shields.io/badge/npm-v3.9.115-7c3aed?style=for-the-badge&logo=npm&logoColor=white&labelColor=18181b)](https://www.npmjs.com/package/pikakit)
8
- [![Skills](https://img.shields.io/badge/skills-51-06b6d4?style=for-the-badge&labelColor=18181b)](https://github.com/pikakit/agent-skills)
9
- [![Workflows](https://img.shields.io/badge/workflows-18-10b981?style=for-the-badge&labelColor=18181b)](https://github.com/pikakit/agent-skills)
10
- [![JavaScript](https://img.shields.io/badge/100%25-JavaScript-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black&labelColor=18181b)](https://github.com/pikakit/agent-skills)
8
+ PikaKit transforms any AI into a Senior Engineer β€” not by prompting harder, but by controlling how it executes, learns, and improves over time.
11
9
 
12
- **Composable Skills Β· Coordinated Agents Β· Intelligent Execution**
13
-
14
- [Install](#-quick-install) Β· [Skills](#-skills-catalog-51) Β· [Workflows](#-workflows-18) Β· [Website](https://pikakit.com)
15
-
16
- </div>
17
-
18
- ---
19
-
20
- ## πŸš€ Quick Install
10
+ [![npm](https://img.shields.io/badge/npm-v3.9.130-7c3aed?style=for-the-badge&logo=npm&logoColor=white&labelColor=18181b)](https://www.npmjs.com/package/pikakit)
11
+ [![Skills](https://img.shields.io/badge/53_skills-06b6d4?style=for-the-badge&labelColor=18181b)](https://github.com/pikakit/agent-skills)
12
+ [![Workflows](https://img.shields.io/badge/19_workflows-10b981?style=for-the-badge&labelColor=18181b)](https://github.com/pikakit/agent-skills)
13
+ [![TypeScript](https://img.shields.io/badge/strict_typescript-3178c6?style=for-the-badge&logo=typescript&logoColor=white&labelColor=18181b)](https://github.com/pikakit/agent-skills)
21
14
 
22
15
  ```bash
23
16
  npx pikakit
24
17
  ```
25
18
 
26
- > One command installs **51 skills**, **18 workflows**, and a complete FAANG-grade AI operating system into your project.
27
-
28
- ### What You Get
19
+ Used with Cursor Β· Windsurf Β· Roo Code Β· Cline Β· Antigravity
29
20
 
30
- | Component | Count | Highlights |
31
- |--------------------|:-----------:|-------------------------------------------------------------------------|
32
- | 🧩 **Skills** | 51 | Architecture, Frontend, Backend, Security, DevOps, AI, Mobile, Testing |
33
- | ⚑ **Workflows** | 18 | `/think` · `/build` · `/autopilot` · `/studio` · `/validate` and more |
34
- | πŸ“œ **Rules** | `GEMINI.md` | AI behavior configuration β€” the Supreme Law |
35
- | πŸ› οΈ **Scripts** | 6 | Checklist, verify, preview, session management |
36
- | πŸ’» **CLI** | `kit` | Skill management Β· `agent` (optional interactive dashboard) |
21
+ </div>
37
22
 
38
23
  ---
39
24
 
40
- ## 🎯 Why PikaKit
41
-
42
- <table>
43
- <tr>
44
- <td width="33%" align="center">
45
-
46
- ### βš™οΈ Auto-Accept
47
- Approve plan **once** β†’ agent runs to completion with **zero interruptions**
48
-
49
- </td>
50
- <td width="33%" align="center">
51
-
52
- ### 🧠 Self-Learning
53
- AI **remembers mistakes** from `lessons-learned.yaml` and never repeats them
54
-
55
- </td>
56
- <td width="33%" align="center">
25
+ ## ⚑ AI Coding is Broken
57
26
 
58
- ### πŸ”§ Custom Skills
59
- Create **project-specific skills** that teach AI your conventions
27
+ Today’s AI tools can write code β€” but they:
28
+ - Break your architecture
29
+ - Forget past mistakes
30
+ - Require constant supervision
31
+ - Produce inconsistent results
60
32
 
61
- </td>
62
- </tr>
63
- </table>
33
+ ## PikaKit Fixes This
64
34
 
65
- | Feature | PikaKit | Generic AI | Other Tools |
66
- |--------------------------------|:-----------------:|:-------------:|:-------------:|
67
- | ⚑ Auto-Accept Workflow | βœ… | ❌ | ❌ |
68
- | 🧠 Self-Learning Memory | βœ… | ❌ | ❌ |
69
- | πŸ’› 100% JavaScript | βœ… | Mixed | Python |
70
- | πŸ›‘οΈ Safety Protocol | TIER -1 | ❌ | ❌ |
71
- | πŸ“‰ Token Efficiency | Modular loading | Baseline | Varies |
72
- | πŸ“Š FAANG-Grade Telemetry | βœ… | ❌ | ❌ |
73
- | 🌍 Multi-language (EN/VI) | βœ… | ❌ | ❌ |
35
+ PikaKit turns AI into a deterministic engineering system:
36
+ - Enforces architecture & best practices
37
+ - Learns from every failure
38
+ - Executes workflows autonomously
39
+ - Ships production-ready code
74
40
 
75
41
  ---
76
42
 
77
- ## ⚑ Quick Start
43
+ ## ⚑ What Makes PikaKit Different?
78
44
 
79
- ### 1. Install
45
+ **Without PikaKit:**
46
+ - AI = autocomplete
47
+ - You = babysitter
48
+ - Bugs = repeated forever
80
49
 
81
- ```bash
82
- npx pikakit
83
- ```
50
+ **With PikaKit:**
51
+ - AI follows enforced engineering rules
52
+ - Errors become permanent knowledge
53
+ - Fixes evolve into reusable Skills
54
+ - Workflows execute end-to-end autonomously
84
55
 
85
- Choose **Project** (`.agent/`) or **Global** (`~/.gemini/`) scope. Optionally install AutoLearn CLI.
56
+ ---
86
57
 
87
- ### 2. Manage Skills
58
+ ## πŸ—οΈ System Overview
88
59
 
89
- ```bash
90
- kit list # List all skills
91
- kit info <skill-name> # Show skill details
92
- kit validate # Validate skill structure
93
- kit doctor # System health check
60
+ ```text
61
+ You β†’ AI β†’ PikaKit β†’ Production Code
62
+ ↑
63
+ Learns from mistakes
94
64
  ```
95
65
 
96
- ### 3. Run Workflows
97
-
98
- ```bash
99
- /think auth system # Brainstorm 3+ approaches
100
- /plan # Generate detailed plan
101
- /build # Multi-agent implementation
102
- /autopilot # Full autonomous execution
103
- /validate # Run test suite
104
- /studio # UI design with 50+ styles
66
+ ### Deep Architecture
67
+
68
+ ```mermaid
69
+ flowchart TD
70
+ subgraph IDE ["PikaKit Engine (VS Code)"]
71
+ A[Real-time Errors] --> B[Auto-click CDP]
72
+ end
73
+ subgraph Brain ["The Knowledge Engine"]
74
+ A -->|Ingest| C(Raw Signals)
75
+ C -->|Compile| D(Concept Wiki)
76
+ D -->|Generate| E[Executable Skills]
77
+ end
78
+ subgraph Runtime ["Workflows & Skills"]
79
+ E --> F[Agent routing & Execution]
80
+ F --> G[Project completed securely]
81
+ end
82
+ style IDE fill:#374151,color:#fff
83
+ style Brain fill:#18181b,color:#fff,stroke:#10b981
84
+ style Runtime fill:#065f46,color:#fff
105
85
  ```
106
86
 
107
87
  ---
108
88
 
109
- ## 🧩 Skills Catalog (51)
110
-
111
- ### πŸ—οΈ Architecture & Planning
112
-
113
- | Skill | Description |
114
- |-----------------------------|-------------------------------------------------|
115
- | `project-planner` | Task planning with dependency graph |
116
- | `idea-storm` | Socratic questioning & brainstorming |
117
- | `lifecycle-orchestrator` | End-to-end task lifecycle management |
118
- | `system-design` | Architecture decisions & ADR |
119
- | `context-engineering` | Token optimization & agent architecture |
120
-
121
- ### 🎨 Frontend & Design
122
-
123
- | Skill | Description |
124
- |-----------------------------|-------------------------------------------------|
125
- | `react-pro` | Modern React patterns, hooks, state management |
126
- | `nextjs-pro` | App Router, RSC, 60+ optimization rules |
127
- | `design-system` | Color theory, typography, UX psychology |
128
- | `studio` | 50+ styles, 97 palettes, 57 font pairings |
129
- | `tailwind-kit` | Tailwind CSS v4 patterns |
130
-
131
- ### βš™οΈ Backend & API
132
-
133
- | Skill | Description |
134
- |-----------------------------|-------------------------------------------------|
135
- | `api-architect` | REST, GraphQL, tRPC design |
136
- | `nodejs-pro` | Hono/Fastify/Express/NestJS patterns |
137
- | `python-pro` | FastAPI, Django, Flask |
138
- | `data-modeler` | Schema design, Prisma/Drizzle |
139
- | `auth-patterns` | OAuth2, JWT, RBAC/ABAC, MFA, Passkeys |
140
-
141
- ### πŸ” Security
142
-
143
- | Skill | Description |
144
- |-----------------------------|-------------------------------------------------|
145
- | `security-scanner` | OWASP 2025, supply chain security |
146
- | `offensive-sec` | Red team tactics, MITRE ATT&CK |
147
- | `code-constitution` | Constitutional governance (Supreme Law) |
148
-
149
- ### πŸ§ͺ Testing & Quality
150
-
151
- | Skill | Description |
152
- |-----------------------------|-------------------------------------------------|
153
- | `test-architect` | Unit, integration, E2E strategies |
154
- | `e2e-automation` | Playwright, visual testing, deep audit |
155
- | `code-craft` | Clean code, SRP, DRY, KISS |
156
- | `code-review` | Linting, static analysis, PR review |
157
- | `problem-checker` | IDE problem detection & auto-fix |
158
-
159
- ### πŸ› Debugging
160
-
161
- | Skill | Description |
162
- |-----------------------------|-------------------------------------------------|
163
- | `debug-pro` | 4-phase methodology + defense-in-depth |
164
- | `chrome-devtools` | Puppeteer CLI, screenshots, Core Web Vitals |
165
- | `knowledge-graph` | AST parsing, find-usages, impact analysis |
166
-
167
- ### πŸ€– AI & Agents
168
-
169
- | Skill | Description |
170
- |-----------------------------|-------------------------------------------------|
171
- | `google-adk-python` | Google Agent Development Kit |
172
- | `auto-learned` | Hierarchical auto-learned patterns |
173
- | `auto-learner` | Pattern extraction from errors |
174
- | `execution-reporter` | Agent routing transparency |
175
- | `smart-router` | Intelligent agent routing |
176
- | `mcp-builder` | Build MCP servers for AI agents |
177
- | `mcp-management` | Discover & execute MCP tools |
178
- | `ai-artist` | Prompt engineering for LLM & image AI |
179
-
180
- ### ☁️ DevOps & Infrastructure
181
-
182
- | Skill | Description |
183
- |-----------------------------|-------------------------------------------------|
184
- | `cicd-pipeline` | Safe deployments, rollback strategies |
185
- | `gitops` | ArgoCD/Flux GitOps workflows |
186
- | `git-workflow` | Conventional commits, secret detection |
187
- | `server-ops` | Process management, scaling |
188
- | `vercel-deploy` | 1-click Vercel deployment |
189
- | `observability` | OpenTelemetry, unified logs/metrics/traces |
190
- | `perf-optimizer` | Core Web Vitals, bundle analysis |
191
-
192
- ### πŸ“± Mobile & Specialized
193
-
194
- | Skill | Description |
195
- |-----------------------------|-------------------------------------------------|
196
- | `mobile-developer` | React Native, Flutter, native |
197
- | `mobile-design` | Mobile-first UI/UX patterns |
198
- | `game-development` | Game logic & mechanics |
199
- | `typescript-expert` | Type-level programming, monorepo |
200
- | `shell-script` | Bash/Linux terminal patterns |
201
-
202
- ### πŸ“ Documentation & Content
203
-
204
- | Skill | Description |
205
- |-----------------------------|-------------------------------------------------|
206
- | `doc-templates` | README, API docs, ADR templates |
207
- | `copywriting` | AIDA, PAS, conversion formulas |
208
- | `seo-optimizer` | SEO, E-E-A-T, Core Web Vitals |
209
- | `media-processing` | FFmpeg, ImageMagick, RMBG |
210
- | `agent-browser` | AI-optimized browser automation |
211
-
212
- ---
213
-
214
- ## πŸ“œ Workflows (18)
215
-
216
- | Command | Purpose | Agents |
217
- |----------------|----------------------------------------|:---------------:|
218
- | `/think` | Brainstorm 3+ approaches | planner |
219
- | `/plan` | Generate detailed `PLAN.md` | planner, explorer |
220
- | `/build` | Full-stack implementation | 3–7 |
221
- | `/autopilot` | Multi-agent autonomous execution | 3+ |
222
- | `/cook` | Direct implementation from instructions | code-craft |
223
- | `/fix` | Quick error remediation | debug-pro |
224
- | `/validate` | Test suite with coverage | qa |
225
- | `/diagnose` | Root cause debugging | debug |
226
- | `/inspect` | Defense-in-depth code review | security |
227
- | `/studio` | UI design (50+ styles, 97 palettes) | frontend |
228
- | `/api` | API development with OpenAPI docs | backend |
229
- | `/mobile` | Mobile app development | mobile |
230
- | `/game` | Game development | gamedev |
231
- | `/chronicle` | Auto-documentation | docs |
232
- | `/launch` | Zero-downtime deployment | devops |
233
- | `/stage` | Dev sandbox & Docker Compose | devops |
234
- | `/monitor` | Observability setup | devops |
235
- | `/optimize` | Performance optimization | perf |
236
-
237
- ---
89
+ ## 🧱 The 4 Pillars
238
90
 
91
+ ### 1️⃣ Executable Skills
92
+ **53 battle-tested engineering capabilities** injected directly into the AI runtime β€” enforcing architecture, security, and performance constraints.
239
93
 
240
- ## πŸ›‘οΈ Safety Protocol (TIER -1)
94
+ ### 2️⃣ Autonomous Workflows
95
+ Run complex tasks with a single command:
96
+ - `/autopilot` β€” plan β†’ build β†’ test β†’ ship
97
+ - `/think` β€” structured decision-making
98
+ - `/diagnose` β€” hypothesis-driven debugging
241
99
 
242
- > **Safety > Recoverability > Correctness > Cleanliness > Convenience**
100
+ ### 3️⃣ Self-Learning Knowledge Engine
101
+ Every failure becomes permanent:
102
+ - **Errors** β†’ captured
103
+ - **Fixes** β†’ compiled
104
+ - **Patterns** β†’ turned into new Skills
243
105
 
244
- | Rule | Description |
245
- |---------------------------------|------------------------------------------------------|
246
- | 🚫 **No Delete** | Never delete files without explicit user confirmation |
247
- | ✍️ **Safe Modify** | Read/Create/Modify allowed; Delete/Overwrite forbidden |
248
- | πŸ—‚οΈ **Git Versioning** | All risky changes get `git stash` or checkpoint commit |
249
- | πŸ” **Rollback Guarantee** | Previous version always recoverable via Git |
250
- | β›” **Human Checkpoint** | Core logic, auth, config require explicit approval |
251
- | πŸ› οΈ **Failure Recovery** | 6-level auto-recovery before escalating to user |
106
+ ### 4️⃣ IDE Execution Layer
107
+ A VS Code extension that gives AI real-world control:
108
+ - Reads errors in real-time
109
+ - Prevents destructive actions
110
+ - Handles UI interactions automatically
252
111
 
253
112
  ---
254
113
 
255
- ## 🧠 Self-Learning System
114
+ ## πŸ›‘οΈ Built for Safe Autonomy
256
115
 
257
- > AI learns from every mistake and **never repeats it**.
116
+ PikaKit operates under strict safeguards:
258
117
 
259
- ```
260
- Error Detected β†’ Root Cause Analysis β†’ Lesson Extracted β†’ lessons-learned.yaml
261
- ↓
262
- Future Prevention ← Pattern Matching ← Auto-Learned Patterns β†β”€β”˜
263
- ```
118
+ - **Human approval** for critical operations
119
+ - **Automatic Git checkpoints** before risky changes
120
+ - **Multi-layer rollback system** (6 levels)
121
+ - **Zero destructive actions** without confirmation
264
122
 
265
- **Teach the AI from your feedback:**
123
+ *Autonomy without control is dangerous. PikaKit gives you both.*
266
124
 
267
- ```
268
- User: "This is a bug β€” you created a new file instead of renaming"
269
- AI: πŸ“š Learned: [LEARN-003] - Use rename, don't create new simplified files
270
- ```
125
+ ---
271
126
 
272
- **View learned lessons:**
127
+ ## ⚑ Get Started in Seconds
273
128
 
274
129
  ```bash
275
- agent # Launch interactive dashboard
276
- agent learn # Teach new patterns
277
- agent recall # Scan for violations
278
- agent stats # View statistics
130
+ npx pikakit
279
131
  ```
280
132
 
281
- ---
282
-
283
- ## πŸ“¦ Project Structure
284
-
285
- ```
286
- your-project/
287
- β”œβ”€β”€ .agent/
288
- β”‚ β”œβ”€β”€ GEMINI.md # AI Rules (Supreme Law)
289
- β”‚ β”‚
290
- β”‚ β”œβ”€β”€ skills/ # 51 Skills
291
- β”‚ β”‚ β”œβ”€β”€ react-pro/
292
- β”‚ β”‚ β”œβ”€β”€ debug-pro/
293
- β”‚ β”‚ β”œβ”€β”€ studio/
294
- β”‚ β”‚ └── ...
295
- β”‚ β”‚
296
- β”‚ β”œβ”€β”€ workflows/ # 18 Workflows
297
- β”‚ β”‚ β”œβ”€β”€ think.md
298
- β”‚ β”‚ β”œβ”€β”€ build.md
299
- β”‚ β”‚ β”œβ”€β”€ autopilot.md
300
- β”‚ β”‚ └── ...
301
- β”‚ β”‚
302
- β”‚ β”œβ”€β”€ agents/ # Specialist Agents
303
- β”‚ β”‚ β”œβ”€β”€ frontend.md
304
- β”‚ β”‚ β”œβ”€β”€ backend.md
305
- β”‚ β”‚ β”œβ”€β”€ security.md
306
- β”‚ β”‚ └── ...
307
- β”‚ β”‚
308
- β”‚ └── config/ # Configuration
309
- β”‚
310
- β”œβ”€β”€ kit.cmd / kit # CLI wrapper
311
- └── agent.cmd / agent # AutoLearn wrapper (optional)
312
- ```
133
+ Then in your AI editor:
134
+ > Run `/autopilot` to rebuild auth using Next.js App Router
313
135
 
314
136
  ---
315
137
 
316
- ## πŸ’» CLI Reference
138
+ ## 🧠 Not a Prompt Library. Not a Wrapper.
317
139
 
318
- ### `kit` (Always Installed)
140
+ PikaKit is an **AI Operating System**.
319
141
 
320
- ```bash
321
- kit list # List all installed skills
322
- kit info <skill-name> # Show skill details
323
- kit validate # Validate skill structure
324
- kit doctor # Check system health
325
- kit cache status # View cache usage
326
- ```
142
+ It sits between your AI and your codebase β€” controlling execution, enforcing rules, and continuously improving outcomes.
327
143
 
328
- ### `agent` (Optional β€” AutoLearn Dashboard)
329
-
330
- ```bash
331
- agent # Launch interactive dashboard
332
- agent learn # Teach new patterns
333
- agent recall # Scan for violations
334
- agent stats # View statistics
335
- agent watch # Real-time monitoring
336
- ```
337
-
338
- > **Note:** Not installing AutoLearn does **not** affect workflows, skills, or agents.
144
+ Like how Docker standardized environments, **PikaKit standardizes AI behavior in production.**
339
145
 
340
146
  ---
341
147
 
342
- ## πŸ”— Links
148
+ ## πŸ”₯ Built for Serious Developers
343
149
 
344
- | Resource | URL |
345
- |-----------------------------|------------------------------------------------------------------------------------------|
346
- | 🌐 **Website** | [pikakit.com](https://pikakit.com) |
347
- | πŸ“§ **Support** | [hello@pikakit.com](mailto:hello@pikakit.com) |
348
- | πŸ“¦ **npm** | [npmjs.com/package/pikakit](https://www.npmjs.com/package/pikakit) |
349
- | πŸ™ **GitHub (Skills)** | [github.com/pikakit/agent-skills](https://github.com/pikakit/agent-skills) |
350
- | πŸ™ **GitHub (CLI)** | [github.com/pikakit/add-skill-kit](https://github.com/pikakit/add-skill-kit) |
351
- | πŸ› **Issues** | [github.com/pikakit/agent-skills/issues](https://github.com/pikakit/agent-skills/issues) |
150
+ Designed for teams who want:
151
+ - Production-grade AI outputs
152
+ - Deterministic behavior
153
+ - Long-term learning systems
352
154
 
353
- ---
155
+ *Not just demos. Not just prototypes.*
354
156
 
355
- ## πŸ“„ License
157
+ ---
356
158
 
357
- Proprietary β€” See [LICENSE](LICENSE) for details.
159
+ ## πŸš€ Stop Prompting. Start Building.
358
160
 
359
- Β© 2026 PikaKit. All Rights Reserved.
161
+ Turn your AI into a real engineer.
360
162
 
361
- ---
163
+ ```bash
164
+ npx pikakit
165
+ ```
362
166
 
363
167
  <div align="center">
364
168
 
365
- **πŸ€– PikaKit v3.9.115**
366
-
367
- *Composable Skills Β· Coordinated Agents Β· Intelligent Execution*
368
-
369
- [pikakit.com](https://pikakit.com) Β· [hello@pikakit.com](mailto:hello@pikakit.com)
169
+ **PikaKit v3.9.130** Β· 53 Skills Β· 21 Agents Β· 19 Workflows Β· Strict TypeScript
370
170
 
371
- **[⭐ Star](https://github.com/pikakit/agent-skills) · [Install Now](#-quick-install) · Build Something Great**
171
+ [⭐ Star on GitHub](https://github.com/pikakit/agent-skills) · [Install via npm](https://www.npmjs.com/package/pikakit) · [pikakit.com](https://pikakit.com)
372
172
 
373
173
  </div>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pikakit",
3
- "version": "3.9.130",
3
+ "version": "3.9.131",
4
4
  "description": "PikaKit FAANG-Grade AI Operating System β€” Install 51 skills, 18 workflows.",
5
5
  "license": "Proprietary",
6
6
  "author": "pikakit <pikakit@gmail.com>",
@@ -37,7 +37,7 @@ The extension is installed automatically during skill installation.
37
37
  cd packages/pikakit-extension
38
38
  npm install && npm run compile
39
39
  npx @vscode/vsce package --allow-missing-repository
40
- code --install-extension pikakit-engine-3.9.130.vsix
40
+ code --install-extension pikakit-engine-3.9.131.vsix
41
41
  ```
42
42
 
43
43
  ### Local Development
@@ -149,4 +149,4 @@ Autopilot includes dangerous command blocking for:
149
149
 
150
150
  ---
151
151
 
152
- ⚑ PikaKit Engine v3.9.130
152
+ ⚑ PikaKit Engine v3.9.131