contextos-agents 2.0.0-beta.2 → 2.0.0-beta.3
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/.agents/AGENTS.md +15 -49
- package/.agents/adapters/cursor/export.js +20 -3
- package/.agents/ctx.js +32 -70
- package/.agents/doctor.js +137 -3
- package/.agents/plugins.js +20 -5
- package/.agents/resolver/canonical-resolver.js +1348 -0
- package/.agents/rules/rule-catalog.js +525 -0
- package/.agents/skills-index.json +6 -166
- package/.agents/stats.js +9 -9
- package/package.json +87 -85
|
@@ -1,200 +1,40 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": "1.0.0",
|
|
3
3
|
"skills": [
|
|
4
|
-
{
|
|
5
|
-
"name": "adapters",
|
|
6
|
-
"description": "Generates agent-specific configuration files from the unified ContextOS format.",
|
|
7
|
-
"path": ".agents/core/skills/adapters/SKILL.md"
|
|
8
|
-
},
|
|
9
|
-
{
|
|
10
|
-
"name": "architecture-diagrams",
|
|
11
|
-
"description": "Interactive, visual architecture and sequence diagrams as code. Generates beautiful, self-contained",
|
|
12
|
-
"path": ".agents/core/skills/architecture-diagrams/SKILL.md"
|
|
13
|
-
},
|
|
14
|
-
{
|
|
15
|
-
"name": "brutalist-design",
|
|
16
|
-
"description": "Raw mechanical interfaces fusing Swiss typographic print with military terminal aesthetics. Rigid grids, extreme type scale contrast, utilitarian color, analog degradation effects. For data-heavy dashboards, portfolios, or editorial sites that need to feel like declassified blueprints.",
|
|
17
|
-
"path": ".agents/core/skills/brutalist-design/SKILL.md"
|
|
18
|
-
},
|
|
19
4
|
{
|
|
20
5
|
"name": "context-manager",
|
|
21
|
-
"description": "Smart context selection engine. Analyzes the current task, consults the",
|
|
6
|
+
"description": "Smart context selection engine. Analyzes the current task, consults the Project Graph, and returns only the documents and skills needed to prevent token overflow.",
|
|
22
7
|
"path": ".agents/core/skills/context-manager/SKILL.md"
|
|
23
8
|
},
|
|
24
9
|
{
|
|
25
10
|
"name": "context-os",
|
|
26
|
-
"description": "
|
|
11
|
+
"description": "Deterministic context compiler and policy engine for AI coding agents.",
|
|
27
12
|
"path": ".agents/core/skills/context-os/SKILL.md"
|
|
28
13
|
},
|
|
29
|
-
{
|
|
30
|
-
"name": "database",
|
|
31
|
-
"description": "Database architecture, schema design, Prisma, Drizzle ORM, indexing strategies, migrations, and N+1 query resolution.",
|
|
32
|
-
"path": ".agents/core/skills/database/SKILL.md"
|
|
33
|
-
},
|
|
34
|
-
{
|
|
35
|
-
"name": "ddd",
|
|
36
|
-
"description": "ContextOS skill for Domain-Driven Design",
|
|
37
|
-
"path": ".agents/core/skills/ddd/SKILL.md"
|
|
38
|
-
},
|
|
39
|
-
{
|
|
40
|
-
"name": "decisions",
|
|
41
|
-
"description": "Architecture Decision Records (ADR) management. Creates, tracks, and queries",
|
|
42
|
-
"path": ".agents/core/skills/decisions/SKILL.md"
|
|
43
|
-
},
|
|
44
|
-
{
|
|
45
|
-
"name": "docker",
|
|
46
|
-
"description": "Docker containerization, multi-stage builds, non-root security, layer caching optimization, and docker-compose standards.",
|
|
47
|
-
"path": ".agents/core/skills/docker/SKILL.md"
|
|
48
|
-
},
|
|
49
14
|
{
|
|
50
15
|
"name": "engineering-workflow",
|
|
51
|
-
"description": "Senior engineering workflow skill. Enforces spec → plan → build → test → review → ship.",
|
|
16
|
+
"description": "Senior engineering workflow skill. Enforces the full development lifecycle: spec → plan → build → test → review → ship.",
|
|
52
17
|
"path": ".agents/core/skills/engineering-workflow/SKILL.md"
|
|
53
18
|
},
|
|
54
|
-
{
|
|
55
|
-
"name": "fastapi",
|
|
56
|
-
"description": "ContextOS skill for FastAPI",
|
|
57
|
-
"path": ".agents/core/skills/fastapi/SKILL.md"
|
|
58
|
-
},
|
|
59
19
|
{
|
|
60
20
|
"name": "gemini-precision",
|
|
61
21
|
"description": "High-precision engineering and execution guardrails optimized for Google Gemini models.",
|
|
62
22
|
"path": ".agents/core/skills/gemini-precision/SKILL.md"
|
|
63
23
|
},
|
|
64
|
-
{
|
|
65
|
-
"name": "generators",
|
|
66
|
-
"description": "Generates project documentation from a single idea. Creates PRD, Architecture,",
|
|
67
|
-
"path": ".agents/core/skills/generators/SKILL.md"
|
|
68
|
-
},
|
|
69
|
-
{
|
|
70
|
-
"name": "graphify",
|
|
71
|
-
"description": "Transforms entire codebases into structured knowledge graphs via Tree-sitter AST parsing.",
|
|
72
|
-
"path": ".agents/core/skills/graphify/SKILL.md"
|
|
73
|
-
},
|
|
74
24
|
{
|
|
75
25
|
"name": "gstack-roles",
|
|
76
|
-
"description": "Role-based AI specialist system. Defines
|
|
26
|
+
"description": "Role-based AI specialist system. Defines specialist roles and teaches the AI to adopt the correct role before each task phase.",
|
|
77
27
|
"path": ".agents/core/skills/gstack-roles/SKILL.md"
|
|
78
28
|
},
|
|
79
|
-
{
|
|
80
|
-
"name": "impeccable-design",
|
|
81
|
-
"description": "Visual design quality enforcement. 50 deterministic anti-pattern rules preventing",
|
|
82
|
-
"path": ".agents/core/skills/impeccable-design/SKILL.md"
|
|
83
|
-
},
|
|
84
|
-
{
|
|
85
|
-
"name": "interview-me",
|
|
86
|
-
"description": "Interactive requirements elicitation skill. Interrogates ambiguous, complex, or high-blast-radius",
|
|
87
|
-
"path": ".agents/core/skills/interview-me/SKILL.md"
|
|
88
|
-
},
|
|
89
|
-
{
|
|
90
|
-
"name": "microservices",
|
|
91
|
-
"description": "ContextOS skill for Microservices",
|
|
92
|
-
"path": ".agents/core/skills/microservices/SKILL.md"
|
|
93
|
-
},
|
|
94
|
-
{
|
|
95
|
-
"name": "minimalist-design",
|
|
96
|
-
"description": "Clean editorial-style interfaces. Warm monochrome palette, typographic contrast, flat bento grids, muted pastels. No gradients, no heavy shadows.",
|
|
97
|
-
"path": ".agents/core/skills/minimalist-design/SKILL.md"
|
|
98
|
-
},
|
|
99
|
-
{
|
|
100
|
-
"name": "nestjs",
|
|
101
|
-
"description": "ContextOS skill for NestJS",
|
|
102
|
-
"path": ".agents/core/skills/nestjs/SKILL.md"
|
|
103
|
-
},
|
|
104
|
-
{
|
|
105
|
-
"name": "nextjs",
|
|
106
|
-
"description": "ContextOS skill for Next.js App Router, Server Components, Server Actions, performance optimization, and Vercel best practices.",
|
|
107
|
-
"path": ".agents/core/skills/nextjs/SKILL.md"
|
|
108
|
-
},
|
|
109
|
-
{
|
|
110
|
-
"name": "node",
|
|
111
|
-
"description": "ContextOS skill for Node.js",
|
|
112
|
-
"path": ".agents/core/skills/node/SKILL.md"
|
|
113
|
-
},
|
|
114
|
-
{
|
|
115
|
-
"name": "performance",
|
|
116
|
-
"description": "ContextOS skill for Web Performance, Core Web Vitals, waterfall elimination, bundle size optimization, and caching strategies.",
|
|
117
|
-
"path": ".agents/core/skills/performance/SKILL.md"
|
|
118
|
-
},
|
|
119
29
|
{
|
|
120
30
|
"name": "ponytail-mindset",
|
|
121
|
-
"description": "Minimalist coding mindset.
|
|
31
|
+
"description": "Minimalist coding mindset. Teaches the AI to write only what is strictly necessary using the 7-rung ladder.",
|
|
122
32
|
"path": ".agents/core/skills/ponytail-mindset/SKILL.md"
|
|
123
33
|
},
|
|
124
|
-
{
|
|
125
|
-
"name": "react",
|
|
126
|
-
"description": "ContextOS skill for modern React (v18/v19), component architecture, state colocation, render optimization, and Vercel performance rules.",
|
|
127
|
-
"path": ".agents/core/skills/react/SKILL.md"
|
|
128
|
-
},
|
|
129
|
-
{
|
|
130
|
-
"name": "react-best-practices",
|
|
131
|
-
"description": "React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.",
|
|
132
|
-
"path": ".agents/core/skills/react-best-practices/SKILL.md"
|
|
133
|
-
},
|
|
134
|
-
{
|
|
135
|
-
"name": "redesign-audit",
|
|
136
|
-
"description": "Upgrades existing websites and apps to premium quality. Audits current design, identifies generic AI patterns, and applies high-end design standards without breaking functionality. Works with any CSS framework or vanilla CSS.",
|
|
137
|
-
"path": ".agents/core/skills/redesign-audit/SKILL.md"
|
|
138
|
-
},
|
|
139
34
|
{
|
|
140
35
|
"name": "security",
|
|
141
|
-
"description": "
|
|
36
|
+
"description": "ContextOS skill for Application Security.",
|
|
142
37
|
"path": ".agents/core/skills/security/SKILL.md"
|
|
143
|
-
},
|
|
144
|
-
{
|
|
145
|
-
"name": "soft-design",
|
|
146
|
-
"description": "Teaches the AI to design like a high-end agency. Defines the exact fonts, spacing, shadows, card structures, and animations that make a website feel expensive. Blocks all the common defaults that make AI designs look cheap or generic.",
|
|
147
|
-
"path": ".agents/core/skills/soft-design/SKILL.md"
|
|
148
|
-
},
|
|
149
|
-
{
|
|
150
|
-
"name": "state-management",
|
|
151
|
-
"description": "Client and server state management standards using Zustand and TanStack Query. Enforces minimal global state, optimistic updates, and clean query invalidation.",
|
|
152
|
-
"path": ".agents/core/skills/state-management/SKILL.md"
|
|
153
|
-
},
|
|
154
|
-
{
|
|
155
|
-
"name": "subagent-orchestrator",
|
|
156
|
-
"description": "Subagent delegation and parallel coordination skill. Implements task decomposition,",
|
|
157
|
-
"path": ".agents/core/skills/subagent-orchestrator/SKILL.md"
|
|
158
|
-
},
|
|
159
|
-
{
|
|
160
|
-
"name": "system-design",
|
|
161
|
-
"description": "Scalable architecture skill based on the System Design Primer.",
|
|
162
|
-
"path": ".agents/core/skills/system-design/SKILL.md"
|
|
163
|
-
},
|
|
164
|
-
{
|
|
165
|
-
"name": "testing",
|
|
166
|
-
"description": "Vitest, React Testing Library, and Playwright testing standards. Enforces TDD/BDD, test pyramid, zero brittle mocks, and complete assertion coverage.",
|
|
167
|
-
"path": ".agents/core/skills/testing/SKILL.md"
|
|
168
|
-
},
|
|
169
|
-
{
|
|
170
|
-
"name": "typescript",
|
|
171
|
-
"description": "ContextOS skill for TypeScript",
|
|
172
|
-
"path": ".agents/core/skills/typescript/SKILL.md"
|
|
173
|
-
},
|
|
174
|
-
{
|
|
175
|
-
"name": "ui-design",
|
|
176
|
-
"description": "ContextOS skill for UI Design",
|
|
177
|
-
"path": ".agents/core/skills/ui-design/SKILL.md"
|
|
178
|
-
},
|
|
179
|
-
{
|
|
180
|
-
"name": "ui-ux-pro",
|
|
181
|
-
"description": "Professional UI/UX design skill. Enforces accessibility, semantic color palettes,",
|
|
182
|
-
"path": ".agents/core/skills/ui-ux-pro/SKILL.md"
|
|
183
|
-
},
|
|
184
|
-
{
|
|
185
|
-
"name": "ux-design",
|
|
186
|
-
"description": "ContextOS skill for UX Design",
|
|
187
|
-
"path": ".agents/core/skills/ux-design/SKILL.md"
|
|
188
|
-
},
|
|
189
|
-
{
|
|
190
|
-
"name": "vercel-optimize",
|
|
191
|
-
"description": "Use for Vercel cost and performance optimization on deployed projects, especially Next.js, SvelteKit, Nuxt, and limited Astro apps. Collect Vercel metrics, usage, project config, and code scan results first; investigate only metric-backed candidates; produce ranked recommendations grounded in verified files and version-aware Vercel/framework docs. Trigger for Vercel bill reduction, slow or expensive routes, caching opportunities, Function Invocations, Build Minutes, Fast Data Transfer, Core Web Vitals, Bot Management, Fluid compute, or cost breakdown requests.",
|
|
192
|
-
"path": ".agents/core/skills/vercel-optimize/SKILL.md"
|
|
193
|
-
},
|
|
194
|
-
{
|
|
195
|
-
"name": "web-accessibility",
|
|
196
|
-
"description": "ContextOS skill for Web Accessibility (WCAG 2.1 AA/AAA), ARIA dialog patterns, keyboard focus traps, and Web Interface Guidelines.",
|
|
197
|
-
"path": ".agents/core/skills/web-accessibility/SKILL.md"
|
|
198
38
|
}
|
|
199
39
|
]
|
|
200
40
|
}
|
package/.agents/stats.js
CHANGED
|
@@ -65,24 +65,24 @@ function calculateContextStats(projectDir = process.cwd()) {
|
|
|
65
65
|
}
|
|
66
66
|
|
|
67
67
|
// Resolved context: dynamically resolved skills for this project's stack
|
|
68
|
-
let
|
|
68
|
+
let candidateResolvedSkills = ['engineering-workflow', 'ponytail-mindset'];
|
|
69
69
|
try {
|
|
70
70
|
const resolver = require('./resolver.js');
|
|
71
71
|
const resolved = resolver.resolveSkills({ prompt: 'Implement standard feature', projectDir });
|
|
72
|
-
if (resolved && Array.isArray(resolved.skills)) {
|
|
73
|
-
|
|
72
|
+
if (resolved && Array.isArray(resolved.skills) && resolved.skills.length > 0) {
|
|
73
|
+
candidateResolvedSkills = resolved.skills;
|
|
74
74
|
}
|
|
75
75
|
} catch (_) {
|
|
76
|
-
|
|
76
|
+
candidateResolvedSkills = ['engineering-workflow', 'ponytail-mindset'];
|
|
77
77
|
}
|
|
78
78
|
|
|
79
|
+
// Only consider skills physically present on disk
|
|
80
|
+
const typicalResolvedSkills = candidateResolvedSkills.filter(s => skillCharMap.has(s));
|
|
81
|
+
|
|
79
82
|
let resolvedChars = agentsMdChars;
|
|
80
|
-
let resolvedSkillCount =
|
|
83
|
+
let resolvedSkillCount = typicalResolvedSkills.length;
|
|
81
84
|
for (const s of typicalResolvedSkills) {
|
|
82
|
-
|
|
83
|
-
resolvedChars += skillCharMap.get(s);
|
|
84
|
-
resolvedSkillCount++;
|
|
85
|
-
}
|
|
85
|
+
resolvedChars += skillCharMap.get(s);
|
|
86
86
|
}
|
|
87
87
|
|
|
88
88
|
const fullTokens = estimateTokens({ length: fullChars });
|
package/package.json
CHANGED
|
@@ -1,87 +1,89 @@
|
|
|
1
1
|
{
|
|
2
|
-
"name":
|
|
3
|
-
"version":
|
|
4
|
-
"description":
|
|
5
|
-
"bin":
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
"files":
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
"
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
2
|
+
"name": "contextos-agents",
|
|
3
|
+
"version": "2.0.0-beta.3",
|
|
4
|
+
"description": "ContextOS — Deterministic context compiler and policy engine for AI agents.",
|
|
5
|
+
"bin": {
|
|
6
|
+
"contextos": "./bin/index.js",
|
|
7
|
+
"contextos-agents": "./bin/index.js",
|
|
8
|
+
"koko-contextos-agents": "./bin/index.js"
|
|
9
|
+
},
|
|
10
|
+
"files": [
|
|
11
|
+
"bin",
|
|
12
|
+
"registry.json",
|
|
13
|
+
"registry.schema.json",
|
|
14
|
+
"registry.v2.schema.json",
|
|
15
|
+
".agents/AGENTS.md",
|
|
16
|
+
".agents/skills.json",
|
|
17
|
+
".agents/ctx.js",
|
|
18
|
+
".agents/validate.js",
|
|
19
|
+
".agents/plugins.js",
|
|
20
|
+
".agents/profiles.js",
|
|
21
|
+
".agents/resolver.js",
|
|
22
|
+
".agents/resolver",
|
|
23
|
+
".agents/rules",
|
|
24
|
+
".agents/doctor.js",
|
|
25
|
+
".agents/stats.js",
|
|
26
|
+
".agents/watch.js",
|
|
27
|
+
".agents/skills-index.json",
|
|
28
|
+
".agents/adapters",
|
|
29
|
+
".agents/core",
|
|
30
|
+
".agents/generated",
|
|
31
|
+
".agents/plugins/contextos",
|
|
32
|
+
".agents/compiled",
|
|
33
|
+
".agents/compiler",
|
|
34
|
+
".agents/schemas",
|
|
35
|
+
".agents/workspace",
|
|
36
|
+
".agents/filesystem",
|
|
37
|
+
".agents/transaction-core",
|
|
38
|
+
".agents/customization-dx.js",
|
|
39
|
+
"benchmarks/v2"
|
|
40
|
+
],
|
|
41
|
+
"scripts": {
|
|
42
|
+
"build": "node .agents/ctx.js compile \u0026\u0026 node .agents/ctx.js export all",
|
|
43
|
+
"compile": "node .agents/ctx.js compile",
|
|
44
|
+
"export": "node .agents/ctx.js export gemini",
|
|
45
|
+
"validate": "node .agents/ctx.js validate",
|
|
46
|
+
"benchmark": "node benchmarks/gemini-issues.js",
|
|
47
|
+
"benchmark:live": "node benchmarks/run-live-benchmark.js",
|
|
48
|
+
"benchmark:runtime": "node benchmarks/run-runtime-benchmark.js",
|
|
49
|
+
"lint:md": "markdownlint README.md CONTRIBUTING.md .agents/core/skills/**/*.md --ignore .agents/generated/** --config .markdownlint.json",
|
|
50
|
+
"check:secrets": "node scripts/check-secrets.js --all",
|
|
51
|
+
"setup:hooks": "node scripts/install-hooks.js",
|
|
52
|
+
"watch": "node .agents/watch.js",
|
|
53
|
+
"test": "node --test --test-concurrency=1 tests/install.test.js tests/lockfile.test.js tests/safe-writer.test.js tests/adapter-safety.test.js tests/update.test.js tests/uninstall.test.js tests/plugin-security.test.js tests/export.test.js tests/skills.test.js tests/validate.test.js tests/plugins.test.js tests/benchmark.test.js tests/profile.test.js tests/resolver.test.js tests/cli-registry.test.js tests/profile-enforcement.test.js tests/doctor-hardening.test.js tests/manifest-compiler.test.js tests/canonical-resolver.test.js tests/workspace-graph.test.js tests/profiles-v2.test.js tests/safe-path.test.js tests/project-lock.test.js tests/journaled-transaction.test.js tests/pure-adapters.test.js tests/prompt-skill-system.test.js tests/runtime-state-machine.test.js tests/verification-reviewer-pipeline.test.js tests/durable-concurrency-locks.test.js tests/transactional-git.test.js tests/sandbox-execution.test.js tests/plugin-supply-chain.test.js tests/platform-hardening.test.js tests/customization-dx.test.js tests/claims-governance.test.js tests/benchmark-v2.test.js tests/init-engine.test.js tests/mutation-paths.test.js tests/tarball-smoke.test.js",
|
|
54
|
+
"prepublishOnly": "npm run validate \u0026\u0026 npm run build"
|
|
55
|
+
},
|
|
56
|
+
"keywords": [
|
|
57
|
+
"context-compiler",
|
|
58
|
+
"context-governance",
|
|
59
|
+
"policy-as-code",
|
|
60
|
+
"ai-agents",
|
|
61
|
+
"coding-agents",
|
|
62
|
+
"developer-tools",
|
|
63
|
+
"cursor",
|
|
64
|
+
"claude-code",
|
|
65
|
+
"github-copilot",
|
|
66
|
+
"gemini",
|
|
67
|
+
"zed",
|
|
68
|
+
"mcp",
|
|
69
|
+
"contextos"
|
|
70
|
+
],
|
|
71
|
+
"author": "koko-o",
|
|
72
|
+
"license": "MIT",
|
|
73
|
+
"repository": {
|
|
74
|
+
"type": "git",
|
|
75
|
+
"url": "https://github.com/kok-o/contextos-agents.git"
|
|
76
|
+
},
|
|
77
|
+
"homepage": "https://github.com/kok-o/contextos-agents#readme",
|
|
78
|
+
"bugs": {
|
|
79
|
+
"url": "https://github.com/kok-o/contextos-agents/issues"
|
|
80
|
+
},
|
|
81
|
+
"engines": {
|
|
82
|
+
"node": "\u003e=18.0.0"
|
|
83
|
+
},
|
|
84
|
+
"devDependencies": {
|
|
85
|
+
"esbuild": "^0.28.2",
|
|
86
|
+
"markdownlint-cli": "^0.43.0",
|
|
87
|
+
"yaml": "^2.9.0"
|
|
88
|
+
}
|
|
87
89
|
}
|