contextos-agents 1.5.0
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 +421 -0
- package/.agents/adapters/aider/export.js +137 -0
- package/.agents/adapters/claude/export.js +55 -0
- package/.agents/adapters/copilot/export.js +107 -0
- package/.agents/adapters/cursor/export.js +210 -0
- package/.agents/adapters/gemini/export.js +115 -0
- package/.agents/adapters/shared.js +119 -0
- package/.agents/adapters/zed/export.js +111 -0
- package/.agents/core/profiles/backend.yaml +47 -0
- package/.agents/core/profiles/enterprise.yaml +46 -0
- package/.agents/core/profiles/frontend.yaml +46 -0
- package/.agents/core/profiles/hackathon.yaml +45 -0
- package/.agents/core/profiles/mvp.yaml +43 -0
- package/.agents/core/profiles/startup.yaml +48 -0
- package/.agents/core/skills/adapters/EXAMPLES.md +19 -0
- package/.agents/core/skills/adapters/SKILL.md +105 -0
- package/.agents/core/skills/adapters/TROUBLESHOOTING.md +7 -0
- package/.agents/core/skills/adapters/VALIDATION.json +12 -0
- package/.agents/core/skills/adapters/skill.yaml +10 -0
- package/.agents/core/skills/architecture-diagrams/SKILL.md +108 -0
- package/.agents/core/skills/architecture-diagrams/VALIDATION.json +12 -0
- package/.agents/core/skills/architecture-diagrams/skill.yaml +8 -0
- package/.agents/core/skills/brutalist-design/SKILL.md +150 -0
- package/.agents/core/skills/brutalist-design/VALIDATION.json +12 -0
- package/.agents/core/skills/brutalist-design/skill.yaml +8 -0
- package/.agents/core/skills/context-manager/EXAMPLES.md +19 -0
- package/.agents/core/skills/context-manager/SKILL.md +126 -0
- package/.agents/core/skills/context-manager/TROUBLESHOOTING.md +7 -0
- package/.agents/core/skills/context-manager/VALIDATION.json +12 -0
- package/.agents/core/skills/context-manager/skill.yaml +10 -0
- package/.agents/core/skills/context-os/EXAMPLES.md +21 -0
- package/.agents/core/skills/context-os/SKILL.md +169 -0
- package/.agents/core/skills/context-os/TROUBLESHOOTING.md +7 -0
- package/.agents/core/skills/context-os/VALIDATION.json +12 -0
- package/.agents/core/skills/context-os/packs.yaml +59 -0
- package/.agents/core/skills/context-os/references/context-rules.md +68 -0
- package/.agents/core/skills/context-os/references/pipeline.md +119 -0
- package/.agents/core/skills/context-os/references/project-graph.md +103 -0
- package/.agents/core/skills/context-os/rules.yaml +135 -0
- package/.agents/core/skills/context-os/skill.yaml +10 -0
- package/.agents/core/skills/database/EXAMPLES.md +74 -0
- package/.agents/core/skills/database/SKILL.md +101 -0
- package/.agents/core/skills/database/TROUBLESHOOTING.md +18 -0
- package/.agents/core/skills/database/VALIDATION.json +11 -0
- package/.agents/core/skills/database/skill.yaml +25 -0
- package/.agents/core/skills/ddd/EXAMPLES.md +42 -0
- package/.agents/core/skills/ddd/SKILL.md +247 -0
- package/.agents/core/skills/ddd/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/ddd/VALIDATION.json +12 -0
- package/.agents/core/skills/ddd/ddd.md +178 -0
- package/.agents/core/skills/ddd/skill.yaml +10 -0
- package/.agents/core/skills/decisions/EXAMPLES.md +35 -0
- package/.agents/core/skills/decisions/SKILL.md +90 -0
- package/.agents/core/skills/decisions/TROUBLESHOOTING.md +13 -0
- package/.agents/core/skills/decisions/VALIDATION.json +12 -0
- package/.agents/core/skills/decisions/skill.yaml +10 -0
- package/.agents/core/skills/docker/EXAMPLES.md +56 -0
- package/.agents/core/skills/docker/SKILL.md +63 -0
- package/.agents/core/skills/docker/TROUBLESHOOTING.md +18 -0
- package/.agents/core/skills/docker/VALIDATION.json +11 -0
- package/.agents/core/skills/docker/skill.yaml +23 -0
- package/.agents/core/skills/engineering-workflow/EXAMPLES.md +57 -0
- package/.agents/core/skills/engineering-workflow/SKILL.md +343 -0
- package/.agents/core/skills/engineering-workflow/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/engineering-workflow/VALIDATION.json +12 -0
- package/.agents/core/skills/engineering-workflow/skill.yaml +13 -0
- package/.agents/core/skills/fastapi/EXAMPLES.md +36 -0
- package/.agents/core/skills/fastapi/SKILL.md +148 -0
- package/.agents/core/skills/fastapi/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/fastapi/VALIDATION.json +12 -0
- package/.agents/core/skills/fastapi/fastapi.md +112 -0
- package/.agents/core/skills/fastapi/skill.yaml +10 -0
- package/.agents/core/skills/gemini-precision/SKILL.md +169 -0
- package/.agents/core/skills/gemini-precision/VALIDATION.json +12 -0
- package/.agents/core/skills/gemini-precision/skill.yaml +9 -0
- package/.agents/core/skills/generators/EXAMPLES.md +19 -0
- package/.agents/core/skills/generators/SKILL.md +112 -0
- package/.agents/core/skills/generators/TROUBLESHOOTING.md +7 -0
- package/.agents/core/skills/generators/VALIDATION.json +12 -0
- package/.agents/core/skills/generators/skill.yaml +10 -0
- package/.agents/core/skills/generators/templates/API.md +77 -0
- package/.agents/core/skills/generators/templates/ARCHITECTURE.md +70 -0
- package/.agents/core/skills/generators/templates/DATABASE.md +42 -0
- package/.agents/core/skills/generators/templates/DECISION.md +46 -0
- package/.agents/core/skills/generators/templates/PRD.md +67 -0
- package/.agents/core/skills/generators/templates/PROJECT_GRAPH.md +56 -0
- package/.agents/core/skills/generators/templates/ROADMAP.md +51 -0
- package/.agents/core/skills/generators/templates/TASKS.md +43 -0
- package/.agents/core/skills/generators/templates/UI.md +73 -0
- package/.agents/core/skills/graphify/EXAMPLES.md +73 -0
- package/.agents/core/skills/graphify/SKILL.md +130 -0
- package/.agents/core/skills/graphify/VALIDATION.json +12 -0
- package/.agents/core/skills/graphify/skill.yaml +13 -0
- package/.agents/core/skills/gstack-roles/EXAMPLES.md +23 -0
- package/.agents/core/skills/gstack-roles/SKILL.md +152 -0
- package/.agents/core/skills/gstack-roles/TROUBLESHOOTING.md +13 -0
- package/.agents/core/skills/gstack-roles/VALIDATION.json +12 -0
- package/.agents/core/skills/gstack-roles/skill.yaml +12 -0
- package/.agents/core/skills/impeccable-design/EXAMPLES.md +26 -0
- package/.agents/core/skills/impeccable-design/SKILL.md +201 -0
- package/.agents/core/skills/impeccable-design/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/impeccable-design/VALIDATION.json +12 -0
- package/.agents/core/skills/impeccable-design/skill.yaml +14 -0
- package/.agents/core/skills/interview-me/SKILL.md +97 -0
- package/.agents/core/skills/interview-me/VALIDATION.json +12 -0
- package/.agents/core/skills/interview-me/skill.yaml +8 -0
- package/.agents/core/skills/microservices/EXAMPLES.md +38 -0
- package/.agents/core/skills/microservices/SKILL.md +164 -0
- package/.agents/core/skills/microservices/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/microservices/VALIDATION.json +12 -0
- package/.agents/core/skills/microservices/microservices.md +119 -0
- package/.agents/core/skills/microservices/skill.yaml +10 -0
- package/.agents/core/skills/minimalist-design/SKILL.md +113 -0
- package/.agents/core/skills/minimalist-design/VALIDATION.json +12 -0
- package/.agents/core/skills/minimalist-design/skill.yaml +8 -0
- package/.agents/core/skills/nestjs/EXAMPLES.md +40 -0
- package/.agents/core/skills/nestjs/SKILL.md +139 -0
- package/.agents/core/skills/nestjs/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/nestjs/VALIDATION.json +12 -0
- package/.agents/core/skills/nestjs/nestjs.md +103 -0
- package/.agents/core/skills/nestjs/skill.yaml +10 -0
- package/.agents/core/skills/nextjs/EXAMPLES.md +40 -0
- package/.agents/core/skills/nextjs/SKILL.md +163 -0
- package/.agents/core/skills/nextjs/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/nextjs/VALIDATION.json +12 -0
- package/.agents/core/skills/nextjs/nextjs.md +67 -0
- package/.agents/core/skills/nextjs/skill.yaml +10 -0
- package/.agents/core/skills/node/EXAMPLES.md +80 -0
- package/.agents/core/skills/node/SKILL.md +128 -0
- package/.agents/core/skills/node/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/node/VALIDATION.json +12 -0
- package/.agents/core/skills/node/node.md +87 -0
- package/.agents/core/skills/node/skill.yaml +10 -0
- package/.agents/core/skills/performance/EXAMPLES.md +30 -0
- package/.agents/core/skills/performance/SKILL.md +75 -0
- package/.agents/core/skills/performance/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/performance/VALIDATION.json +12 -0
- package/.agents/core/skills/performance/performance.md +52 -0
- package/.agents/core/skills/performance/skill.yaml +10 -0
- package/.agents/core/skills/ponytail-mindset/EXAMPLES.md +45 -0
- package/.agents/core/skills/ponytail-mindset/SKILL.md +193 -0
- package/.agents/core/skills/ponytail-mindset/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/ponytail-mindset/VALIDATION.json +12 -0
- package/.agents/core/skills/ponytail-mindset/skill.yaml +14 -0
- package/.agents/core/skills/react/EXAMPLES.md +79 -0
- package/.agents/core/skills/react/SKILL.md +132 -0
- package/.agents/core/skills/react/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/react/VALIDATION.json +12 -0
- package/.agents/core/skills/react/react.md +93 -0
- package/.agents/core/skills/react/skill.yaml +10 -0
- package/.agents/core/skills/react-best-practices/SKILL.md +155 -0
- package/.agents/core/skills/react-best-practices/VALIDATION.json +12 -0
- package/.agents/core/skills/react-best-practices/skill.yaml +10 -0
- package/.agents/core/skills/redesign-audit/SKILL.md +117 -0
- package/.agents/core/skills/redesign-audit/VALIDATION.json +12 -0
- package/.agents/core/skills/redesign-audit/skill.yaml +8 -0
- package/.agents/core/skills/security/EXAMPLES.md +64 -0
- package/.agents/core/skills/security/SKILL.md +158 -0
- package/.agents/core/skills/security/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/security/VALIDATION.json +12 -0
- package/.agents/core/skills/security/security.md +106 -0
- package/.agents/core/skills/security/skill.yaml +10 -0
- package/.agents/core/skills/soft-design/SKILL.md +108 -0
- package/.agents/core/skills/soft-design/VALIDATION.json +12 -0
- package/.agents/core/skills/soft-design/skill.yaml +8 -0
- package/.agents/core/skills/state-management/EXAMPLES.md +56 -0
- package/.agents/core/skills/state-management/SKILL.md +48 -0
- package/.agents/core/skills/state-management/TROUBLESHOOTING.md +18 -0
- package/.agents/core/skills/state-management/VALIDATION.json +11 -0
- package/.agents/core/skills/state-management/skill.yaml +22 -0
- package/.agents/core/skills/subagent-orchestrator/SKILL.md +100 -0
- package/.agents/core/skills/subagent-orchestrator/VALIDATION.json +12 -0
- package/.agents/core/skills/subagent-orchestrator/skill.yaml +8 -0
- package/.agents/core/skills/system-design/EXAMPLES.md +75 -0
- package/.agents/core/skills/system-design/SKILL.md +419 -0
- package/.agents/core/skills/system-design/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/system-design/VALIDATION.json +12 -0
- package/.agents/core/skills/system-design/skill.yaml +13 -0
- package/.agents/core/skills/system-design/system-design.md +112 -0
- package/.agents/core/skills/testing/EXAMPLES.md +71 -0
- package/.agents/core/skills/testing/SKILL.md +70 -0
- package/.agents/core/skills/testing/TROUBLESHOOTING.md +18 -0
- package/.agents/core/skills/testing/VALIDATION.json +11 -0
- package/.agents/core/skills/testing/skill.yaml +26 -0
- package/.agents/core/skills/typescript/EXAMPLES.md +64 -0
- package/.agents/core/skills/typescript/SKILL.md +112 -0
- package/.agents/core/skills/typescript/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/typescript/VALIDATION.json +12 -0
- package/.agents/core/skills/typescript/skill.yaml +10 -0
- package/.agents/core/skills/typescript/typescript.md +71 -0
- package/.agents/core/skills/ui-design/EXAMPLES.md +21 -0
- package/.agents/core/skills/ui-design/SKILL.md +124 -0
- package/.agents/core/skills/ui-design/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/ui-design/VALIDATION.json +12 -0
- package/.agents/core/skills/ui-design/skill.yaml +10 -0
- package/.agents/core/skills/ui-design/ui.md +88 -0
- package/.agents/core/skills/ui-ux-pro/EXAMPLES.md +62 -0
- package/.agents/core/skills/ui-ux-pro/SKILL.md +375 -0
- package/.agents/core/skills/ui-ux-pro/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/ui-ux-pro/VALIDATION.json +12 -0
- package/.agents/core/skills/ui-ux-pro/skill.yaml +13 -0
- package/.agents/core/skills/ux-design/EXAMPLES.md +36 -0
- package/.agents/core/skills/ux-design/SKILL.md +116 -0
- package/.agents/core/skills/ux-design/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/ux-design/VALIDATION.json +12 -0
- package/.agents/core/skills/ux-design/skill.yaml +10 -0
- package/.agents/core/skills/ux-design/ux.md +80 -0
- package/.agents/core/skills/vercel-optimize/SKILL.md +83 -0
- package/.agents/core/skills/vercel-optimize/VALIDATION.json +12 -0
- package/.agents/core/skills/vercel-optimize/skill.yaml +10 -0
- package/.agents/core/skills/web-accessibility/EXAMPLES.md +39 -0
- package/.agents/core/skills/web-accessibility/SKILL.md +170 -0
- package/.agents/core/skills/web-accessibility/TROUBLESHOOTING.md +19 -0
- package/.agents/core/skills/web-accessibility/VALIDATION.json +12 -0
- package/.agents/core/skills/web-accessibility/accessibility.md +63 -0
- package/.agents/core/skills/web-accessibility/skill.yaml +10 -0
- package/.agents/ctx.js +370 -0
- package/.agents/generated/claude/skills/adapters/SKILL.md +126 -0
- package/.agents/generated/claude/skills/architecture-diagrams/SKILL.md +101 -0
- package/.agents/generated/claude/skills/brutalist-design/SKILL.md +145 -0
- package/.agents/generated/claude/skills/context-manager/SKILL.md +147 -0
- package/.agents/generated/claude/skills/context-os/SKILL.md +191 -0
- package/.agents/generated/claude/skills/database/SKILL.md +191 -0
- package/.agents/generated/claude/skills/ddd/SKILL.md +305 -0
- package/.agents/generated/claude/skills/decisions/SKILL.md +134 -0
- package/.agents/generated/claude/skills/docker/SKILL.md +135 -0
- package/.agents/generated/claude/skills/engineering-workflow/SKILL.md +414 -0
- package/.agents/generated/claude/skills/fastapi/SKILL.md +200 -0
- package/.agents/generated/claude/skills/gemini-precision/SKILL.md +161 -0
- package/.agents/generated/claude/skills/generators/SKILL.md +133 -0
- package/.agents/generated/claude/skills/graphify/SKILL.md +198 -0
- package/.agents/generated/claude/skills/gstack-roles/SKILL.md +184 -0
- package/.agents/generated/claude/skills/impeccable-design/SKILL.md +241 -0
- package/.agents/generated/claude/skills/interview-me/SKILL.md +90 -0
- package/.agents/generated/claude/skills/microservices/SKILL.md +218 -0
- package/.agents/generated/claude/skills/minimalist-design/SKILL.md +108 -0
- package/.agents/generated/claude/skills/nestjs/SKILL.md +195 -0
- package/.agents/generated/claude/skills/nextjs/SKILL.md +219 -0
- package/.agents/generated/claude/skills/node/SKILL.md +224 -0
- package/.agents/generated/claude/skills/performance/SKILL.md +121 -0
- package/.agents/generated/claude/skills/ponytail-mindset/SKILL.md +252 -0
- package/.agents/generated/claude/skills/react/SKILL.md +227 -0
- package/.agents/generated/claude/skills/react-best-practices/SKILL.md +146 -0
- package/.agents/generated/claude/skills/redesign-audit/SKILL.md +112 -0
- package/.agents/generated/claude/skills/security/SKILL.md +237 -0
- package/.agents/generated/claude/skills/soft-design/SKILL.md +103 -0
- package/.agents/generated/claude/skills/state-management/SKILL.md +120 -0
- package/.agents/generated/claude/skills/subagent-orchestrator/SKILL.md +93 -0
- package/.agents/generated/claude/skills/system-design/SKILL.md +507 -0
- package/.agents/generated/claude/skills/testing/SKILL.md +157 -0
- package/.agents/generated/claude/skills/typescript/SKILL.md +192 -0
- package/.agents/generated/claude/skills/ui-design/SKILL.md +161 -0
- package/.agents/generated/claude/skills/ui-ux-pro/SKILL.md +451 -0
- package/.agents/generated/claude/skills/ux-design/SKILL.md +168 -0
- package/.agents/generated/claude/skills/vercel-optimize/SKILL.md +76 -0
- package/.agents/generated/claude/skills/web-accessibility/SKILL.md +225 -0
- package/.agents/generated/gemini/skills/adapters/SKILL.md +135 -0
- package/.agents/generated/gemini/skills/architecture-diagrams/SKILL.md +107 -0
- package/.agents/generated/gemini/skills/brutalist-design/SKILL.md +151 -0
- package/.agents/generated/gemini/skills/context-manager/SKILL.md +156 -0
- package/.agents/generated/gemini/skills/context-os/SKILL.md +200 -0
- package/.agents/generated/gemini/skills/database/SKILL.md +200 -0
- package/.agents/generated/gemini/skills/ddd/SKILL.md +314 -0
- package/.agents/generated/gemini/skills/decisions/SKILL.md +143 -0
- package/.agents/generated/gemini/skills/docker/SKILL.md +144 -0
- package/.agents/generated/gemini/skills/engineering-workflow/SKILL.md +423 -0
- package/.agents/generated/gemini/skills/fastapi/SKILL.md +209 -0
- package/.agents/generated/gemini/skills/gemini-precision/SKILL.md +167 -0
- package/.agents/generated/gemini/skills/generators/SKILL.md +142 -0
- package/.agents/generated/gemini/skills/graphify/SKILL.md +205 -0
- package/.agents/generated/gemini/skills/gstack-roles/SKILL.md +193 -0
- package/.agents/generated/gemini/skills/impeccable-design/SKILL.md +250 -0
- package/.agents/generated/gemini/skills/interview-me/SKILL.md +96 -0
- package/.agents/generated/gemini/skills/microservices/SKILL.md +227 -0
- package/.agents/generated/gemini/skills/minimalist-design/SKILL.md +114 -0
- package/.agents/generated/gemini/skills/nestjs/SKILL.md +204 -0
- package/.agents/generated/gemini/skills/nextjs/SKILL.md +298 -0
- package/.agents/generated/gemini/skills/node/SKILL.md +323 -0
- package/.agents/generated/gemini/skills/performance/SKILL.md +185 -0
- package/.agents/generated/gemini/skills/ponytail-mindset/SKILL.md +261 -0
- package/.agents/generated/gemini/skills/react/SKILL.md +332 -0
- package/.agents/generated/gemini/skills/react-best-practices/SKILL.md +152 -0
- package/.agents/generated/gemini/skills/redesign-audit/SKILL.md +118 -0
- package/.agents/generated/gemini/skills/security/SKILL.md +355 -0
- package/.agents/generated/gemini/skills/soft-design/SKILL.md +109 -0
- package/.agents/generated/gemini/skills/state-management/SKILL.md +129 -0
- package/.agents/generated/gemini/skills/subagent-orchestrator/SKILL.md +99 -0
- package/.agents/generated/gemini/skills/system-design/SKILL.md +631 -0
- package/.agents/generated/gemini/skills/testing/SKILL.md +166 -0
- package/.agents/generated/gemini/skills/typescript/SKILL.md +275 -0
- package/.agents/generated/gemini/skills/ui-design/SKILL.md +170 -0
- package/.agents/generated/gemini/skills/ui-ux-pro/SKILL.md +460 -0
- package/.agents/generated/gemini/skills/ux-design/SKILL.md +177 -0
- package/.agents/generated/gemini/skills/vercel-optimize/SKILL.md +82 -0
- package/.agents/generated/gemini/skills/web-accessibility/SKILL.md +300 -0
- package/.agents/mcp/runtime.py +454 -0
- package/.agents/mcp/server.mjs +189373 -0
- package/.agents/plugins.js +574 -0
- package/.agents/profiles.js +267 -0
- package/.agents/resolver.js +336 -0
- package/.agents/skills-index.json +200 -0
- package/.agents/skills.json +6 -0
- package/.agents/validate.js +500 -0
- package/LICENSE +21 -0
- package/README.md +415 -0
- package/benchmarks/gemini-issues.js +533 -0
- package/bin/index.js +458 -0
- package/package.json +70 -0
- package/registry.json +53 -0
- package/registry.schema.json +32 -0
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: industrial-brutalist-ui
|
|
3
|
+
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.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# SKILL: Industrial Brutalism & Tactical Telemetry UI
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
Advanced proficiency in architecting web interfaces that synthesize mid-century Swiss Typographic design, industrial manufacturing manuals, and retro-futuristic aerospace/military terminal interfaces. This discipline requires absolute mastery over rigid modular grids, extreme typographic scale contrast, purely utilitarian color palettes, and the programmatic simulation of analog degradation (halftones, CRT scanlines, bitmap dithering). The objective is to construct digital environments that project raw functionality, mechanical precision, and high data density, deliberately discarding conventional consumer UI patterns.
|
|
11
|
+
|
|
12
|
+
## When to Use
|
|
13
|
+
|
|
14
|
+
- When building data-heavy telemetry dashboards, analytics monitors, trading systems, or developer command centers.
|
|
15
|
+
- When creating editorial portfolios, archival indexes, or technical documentation sites requiring an industrial blueprint aesthetic.
|
|
16
|
+
- When explicitly prompted for "brutalist", "tactical", "terminal", "Swiss print", or "mechanical" aesthetics.
|
|
17
|
+
|
|
18
|
+
## Rules & Patterns
|
|
19
|
+
|
|
20
|
+
### 1. Visual Archetypes
|
|
21
|
+
|
|
22
|
+
Pick ONE per project and commit to it. Do not alternate or mix both modes within the same interface.
|
|
23
|
+
|
|
24
|
+
#### 1.1 Swiss Industrial Print
|
|
25
|
+
|
|
26
|
+
Derived from 1960s corporate identity systems and heavy machinery blueprints.
|
|
27
|
+
|
|
28
|
+
- **Characteristics:** High-contrast light modes (newsprint/off-white substrates). Reliance on monolithic, heavy sans-serif typography. Unforgiving structural grids outlined by visible dividing lines. Aggressive, asymmetric use of negative space punctuated by oversized, viewport-bleeding numerals or letterforms. Heavy use of primary red as an alert/accent color.
|
|
29
|
+
|
|
30
|
+
#### 1.2 Tactical Telemetry & CRT Terminal
|
|
31
|
+
|
|
32
|
+
Derived from classified military databases, legacy mainframes, and aerospace Heads-Up Displays (HUDs).
|
|
33
|
+
|
|
34
|
+
- **Characteristics:** Dark mode exclusivity. High-density tabular data presentation. Absolute dominance of monospaced typography. Integration of technical framing devices (ASCII brackets, crosshairs). Application of simulated hardware limitations (phosphor glow, scanlines, low bit-depth rendering).
|
|
35
|
+
|
|
36
|
+
### 2. Typographic Architecture
|
|
37
|
+
|
|
38
|
+
Typography is the primary structural and decorative infrastructure. Imagery is secondary. The system demands extreme variance in scale, weight, and spacing.
|
|
39
|
+
|
|
40
|
+
#### 2.1 Macro-Typography (Structural Headers)
|
|
41
|
+
|
|
42
|
+
- **Classification:** Neo-Grotesque / Heavy Sans-Serif.
|
|
43
|
+
- **Optimal Web Fonts:** Neue Haas Grotesk (Black), Inter (Extra Bold/Black), Archivo Black, Roboto Flex (Heavy), Monument Extended.
|
|
44
|
+
- **Scale:** Deployed at massive scales using fluid typography (e.g., `clamp(4rem, 10vw, 15rem)`).
|
|
45
|
+
- **Tracking (Letter-spacing):** Extremely tight, often negative (`-0.03em` to `-0.06em`), forcing glyphs to form solid architectural blocks.
|
|
46
|
+
- **Leading (Line-height):** Highly compressed (`0.85` to `0.95`).
|
|
47
|
+
- **Casing:** Exclusively uppercase for structural impact.
|
|
48
|
+
|
|
49
|
+
#### 2.2 Micro-Typography (Data & Telemetry)
|
|
50
|
+
|
|
51
|
+
- **Classification:** Monospace / Technical Sans.
|
|
52
|
+
- **Optimal Web Fonts:** JetBrains Mono, IBM Plex Mono, Space Mono, VT323, Courier Prime.
|
|
53
|
+
- **Scale:** Fixed and small (`10px` to `14px` / `0.7rem` to `0.875rem`).
|
|
54
|
+
- **Tracking:** Generous (`0.05em` to `0.1em`) to simulate mechanical typewriter spacing or terminal matrices.
|
|
55
|
+
- **Leading:** Standard to tight (`1.2` to `1.4`).
|
|
56
|
+
- **Casing:** Exclusively uppercase. Used for all metadata, navigation, unit IDs, and coordinates.
|
|
57
|
+
|
|
58
|
+
#### 2.3 Textural Contrast (Artistic Disruption)
|
|
59
|
+
|
|
60
|
+
- **Classification:** High-Contrast Serif.
|
|
61
|
+
- **Optimal Web Fonts:** Playfair Display, EB Garamond, Times New Roman.
|
|
62
|
+
- **Implementation Parameters:** Used exceedingly sparingly. Must be subjected to heavy post-processing (halftone filters, 1-bit dithering) to degrade vector perfection and create textural juxtaposition against the clean sans-serifs.
|
|
63
|
+
|
|
64
|
+
### 3. Color System
|
|
65
|
+
|
|
66
|
+
The color architecture is uncompromising. Gradients, soft drop shadows, and modern translucency are strictly prohibited. Colors simulate physical media or primitive emissive displays.
|
|
67
|
+
|
|
68
|
+
**CRITICAL: Choose ONE substrate palette per project and use it consistently. Never mix light and dark substrates within the same interface.**
|
|
69
|
+
|
|
70
|
+
#### Swiss Industrial Print Light Substrate
|
|
71
|
+
|
|
72
|
+
- **Background:** `#F4F4F0` or `#EAE8E3` (Matte, unbleached documentation paper).
|
|
73
|
+
- **Foreground:** `#050505` to `#111111` (Carbon Ink).
|
|
74
|
+
- **Accent:** `#E61919` or `#FF2A2A` (Aviation/Hazard Red). This is the ONLY accent color. Used for strike-throughs, thick structural dividing lines, or vital data highlights.
|
|
75
|
+
|
|
76
|
+
#### Tactical Telemetry Dark Substrate
|
|
77
|
+
|
|
78
|
+
- **Background:** `#0A0A0A` or `#121212` (Deactivated CRT. Avoid pure `#000000`).
|
|
79
|
+
- **Foreground:** `#EAEAEA` (White phosphor). This is the primary text color.
|
|
80
|
+
- **Accent:** `#E61919` or `#FF2A2A` (Aviation/Hazard Red). Same red, same rules.
|
|
81
|
+
- **Terminal Green (`#4AF626`):** Optional. Use ONLY for a single specific UI element (e.g., one status indicator or one data readout) — never as a general text color. If it doesn't serve a clear purpose, omit it entirely.
|
|
82
|
+
|
|
83
|
+
### 4. Layout and Spatial Engineering
|
|
84
|
+
|
|
85
|
+
- **The Blueprint Grid:** Strict adherence to CSS Grid architectures. Elements do not float; they are anchored precisely to grid tracks and intersections.
|
|
86
|
+
- **Visible Compartmentalization:** Extensive utilization of solid borders (`1px` or `2px solid`) to delineate distinct zones of information. Horizontal rules (`<hr>`) frequently span the entire container width to segregate operational units.
|
|
87
|
+
- **Bimodal Density:** Layouts oscillate between extreme data density (tightly packed monospace metadata clustered together) and vast expanses of calculated negative space framing macro-typography.
|
|
88
|
+
- **Geometry:** Absolute rejection of `border-radius`. All corners must be exactly 90 degrees to enforce mechanical rigidity.
|
|
89
|
+
|
|
90
|
+
### 5. UI Components and Symbology
|
|
91
|
+
|
|
92
|
+
- **Syntax Decoration:** Utilization of ASCII characters to frame data points (`[ DELIVERY SYSTEMS ]`, `< RE-IND >`, `>>>`, `///`).
|
|
93
|
+
- **Industrial Markers:** Prominent integration of registration (`®`), copyright (`©`), and trademark (`™`) symbols functioning as structural geometric elements rather than legal text.
|
|
94
|
+
- **Technical Assets:** Integration of crosshairs (`+`) at grid intersections, repeating vertical lines (barcodes), thick horizontal warning stripes, and randomized string data (`REV 2.6`, `UNIT / D-01`) to simulate active mechanical processes.
|
|
95
|
+
|
|
96
|
+
### 6. Textural and Post-Processing Effects
|
|
97
|
+
|
|
98
|
+
- **Halftone and 1-Bit Dithering:** Dot-matrix effects via `mix-blend-mode: multiply` overlays combined with SVG radial dot patterns.
|
|
99
|
+
- **CRT Scanlines:** `repeating-linear-gradient(0deg, transparent, transparent 2px, rgba(0,0,0,0.1) 2px, rgba(0,0,0,0.1) 4px)` on terminal backgrounds.
|
|
100
|
+
- **Mechanical Noise:** Low-opacity SVG static filter on the DOM root to introduce physical grain.
|
|
101
|
+
|
|
102
|
+
### 7. Web Engineering Directives
|
|
103
|
+
|
|
104
|
+
1. **Grid Determinism:** Utilize `display: grid; gap: 1px;` with contrasting parent/child background colors to generate mathematically perfect, razor-thin dividing lines without complex border declarations.
|
|
105
|
+
2. **Semantic Rigidity:** Construct the DOM using precise semantic tags (`<data>`, `<samp>`, `<kbd>`, `<output>`, `<dl>`) to accurately reflect the technical nature of the telemetry.
|
|
106
|
+
3. **Typography Clamping:** Implement CSS `clamp()` functions exclusively for macro-typography to ensure massive text scales aggressively while maintaining structural integrity across viewports.
|
|
107
|
+
|
|
108
|
+
## Code Examples
|
|
109
|
+
|
|
110
|
+
```tsx
|
|
111
|
+
export function TelemetryModule({ unitId, status, metrics }: { unitId: string; status: string; metrics: { label: string; val: string }[] }) {
|
|
112
|
+
return (
|
|
113
|
+
<div className="border-2 border-black dark:border-white bg-[#F4F4F0] dark:bg-[#0A0A0A] font-mono p-4 rounded-none">
|
|
114
|
+
<div className="flex justify-between border-b border-black/30 dark:border-white/30 pb-2 mb-4 text-xs tracking-widest uppercase">
|
|
115
|
+
<span>[ UNIT // {unitId} ]</span>
|
|
116
|
+
<span className="text-[#E61919] font-bold">< STATUS: {status} ></span>
|
|
117
|
+
</div>
|
|
118
|
+
<div className="grid grid-cols-2 gap-px bg-black/20 dark:bg-white/20">
|
|
119
|
+
{metrics.map(m => (
|
|
120
|
+
<div key={m.label} className="bg-[#F4F4F0] dark:bg-[#0A0A0A] p-2">
|
|
121
|
+
<div className="text-[10px] text-black/60 dark:text-white/60 tracking-wider">{m.label}</div>
|
|
122
|
+
<div className="text-sm font-bold tracking-tight">{m.val}</div>
|
|
123
|
+
</div>
|
|
124
|
+
))}
|
|
125
|
+
</div>
|
|
126
|
+
</div>
|
|
127
|
+
);
|
|
128
|
+
}
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
## Validation Checklist
|
|
132
|
+
|
|
133
|
+
- [ ] Strict rejection of `border-radius` (all corners 0px / 90 degrees).
|
|
134
|
+
- [ ] Substrate consistency: 100% committed to either Swiss Light or Tactical CRT Dark.
|
|
135
|
+
- [ ] Pure black (`#000000`) avoided for backgrounds.
|
|
136
|
+
- [ ] Monospace typography used for all telemetry, coordinates, and metadata labels.
|
|
137
|
+
- [ ] Dividing lines engineered using solid borders or 1px grid track gaps.
|
|
138
|
+
- [ ] No soft gradients, standard drop shadows, or floating cards.
|
|
139
|
+
|
|
140
|
+
## Common Mistakes
|
|
141
|
+
|
|
142
|
+
- Mixing Swiss Industrial Print and Tactical Telemetry substrates within the same view.
|
|
143
|
+
- Introducing rounded corners (`rounded-md`, `rounded-full`) or pill buttons.
|
|
144
|
+
- Using generic body typefaces without tracking adjustments.
|
|
145
|
+
- Applying subtle pastel colors instead of raw carbon ink, off-white, and hazard red.
|
|
146
|
+
|
|
147
|
+
## Integration Notes
|
|
148
|
+
|
|
149
|
+
- Complements `impeccable-design` for QA checks on contrast and typography.
|
|
150
|
+
- Pairs with `web-accessibility` to guarantee high-contrast readability (AAA ratio).
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# context-manager Examples — Anti-patterns vs ContextOS Standard
|
|
2
|
+
|
|
3
|
+
## Example 1: Context Selection
|
|
4
|
+
|
|
5
|
+
### Anti-pattern: Context Window Dumping
|
|
6
|
+
|
|
7
|
+
```text
|
|
8
|
+
Agent reads all 180 files in src/ into context to debug a single button click handler.
|
|
9
|
+
Result: Exhausts 150k tokens, reaches rate limits, and forgets user instructions.
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
### Best practice: ContextOS Standard (Targeted AST Traversal)
|
|
13
|
+
|
|
14
|
+
```text
|
|
15
|
+
1. Inspect package.json and AGENTS.md.
|
|
16
|
+
2. Grep for target symbol: grep_search for 'SubmitButton'.
|
|
17
|
+
3. Read ONLY components/SubmitButton.tsx and its direct import types/button.ts.
|
|
18
|
+
Total tokens used: <1,500 tokens. Fast, accurate, zero hallucinations.
|
|
19
|
+
```
|
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: context-manager
|
|
3
|
+
description: >
|
|
4
|
+
Smart context selection engine. Analyzes the current task, consults the
|
|
5
|
+
Project Graph, and returns only the documents and skills needed.
|
|
6
|
+
Prevents context window overflow by loading minimum relevant information.
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# context-manager
|
|
10
|
+
|
|
11
|
+
## Overview
|
|
12
|
+
|
|
13
|
+
Deterministic context window optimizer. Analyzes user task intent and queries project dependency graphs to inject minimal relevant files and skills, preventing LLM attention loss and context pollution.
|
|
14
|
+
|
|
15
|
+
## When to Use
|
|
16
|
+
|
|
17
|
+
Activate during multi-file investigations, large refactorings, or complex tasks where dumping entire directory trees would blow past context budgets.
|
|
18
|
+
|
|
19
|
+
## Rules & Patterns
|
|
20
|
+
|
|
21
|
+
You are the **Context Manager**. Your job is to prevent context overload.
|
|
22
|
+
|
|
23
|
+
## How It Works
|
|
24
|
+
|
|
25
|
+
When given a task:
|
|
26
|
+
|
|
27
|
+
### Step 1: Classify the task
|
|
28
|
+
|
|
29
|
+
```yaml
|
|
30
|
+
task:
|
|
31
|
+
type: [frontend | backend | fullstack | architecture | bugfix | refactor | deploy | review]
|
|
32
|
+
scope: [module | feature | file | project-wide]
|
|
33
|
+
module: {{module_name from Project Graph}}
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
### Step 2: Consult the Project Graph
|
|
37
|
+
|
|
38
|
+
If `docs/PROJECT_GRAPH.md` or `.graphify/graph.json` exists (or activate `graphify` skill to extract AST dependencies):
|
|
39
|
+
|
|
40
|
+
1. Find the module this task belongs to
|
|
41
|
+
2. Get the module's dependencies
|
|
42
|
+
3. Get the module's required skills
|
|
43
|
+
4. Get the files this task will likely touch
|
|
44
|
+
|
|
45
|
+
### Step 3: Apply Context Rules
|
|
46
|
+
|
|
47
|
+
Load `references/context-rules.md` and apply the task type → document mapping.
|
|
48
|
+
|
|
49
|
+
### Step 4: Return Context Package
|
|
50
|
+
|
|
51
|
+
Output a context package:
|
|
52
|
+
|
|
53
|
+
```yaml
|
|
54
|
+
context:
|
|
55
|
+
documents:
|
|
56
|
+
required:
|
|
57
|
+
- docs/API.md # sections: [appointments]
|
|
58
|
+
- docs/ARCHITECTURE.md # sections: [backend, api-layer]
|
|
59
|
+
optional:
|
|
60
|
+
- docs/decisions/0003-postgres.md
|
|
61
|
+
skipped:
|
|
62
|
+
- docs/UI.md # reason: backend task
|
|
63
|
+
- docs/DATABASE.md # reason: no schema change
|
|
64
|
+
|
|
65
|
+
skills:
|
|
66
|
+
loaded: [typescript, node, postgres, testing]
|
|
67
|
+
skipped: [react, tailwind] # reason: backend task
|
|
68
|
+
|
|
69
|
+
project_graph:
|
|
70
|
+
module: appointments
|
|
71
|
+
dependencies: [auth, patients]
|
|
72
|
+
affected_files:
|
|
73
|
+
- src/modules/appointments/api/**
|
|
74
|
+
- src/modules/appointments/services/**
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
### Step 5: Validate Budget
|
|
78
|
+
|
|
79
|
+
Check total token count. If over budget (see context-rules.md):
|
|
80
|
+
|
|
81
|
+
1. Trim Level 1 docs to summaries
|
|
82
|
+
2. Load only affected sections of Level 2 docs
|
|
83
|
+
3. Keep Level 3 (skills) at full detail
|
|
84
|
+
|
|
85
|
+
## Context Caching
|
|
86
|
+
|
|
87
|
+
After first compilation for a module, cache the result:
|
|
88
|
+
|
|
89
|
+
```
|
|
90
|
+
.cache/
|
|
91
|
+
frontend.context.yaml
|
|
92
|
+
backend.context.yaml
|
|
93
|
+
appointments.context.yaml
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
Invalidate cache when:
|
|
97
|
+
|
|
98
|
+
- A document is updated
|
|
99
|
+
- A skill is added/removed
|
|
100
|
+
- The Project Graph changes
|
|
101
|
+
- A Decision Record is added
|
|
102
|
+
|
|
103
|
+
## Questions the Context Manager Can Answer
|
|
104
|
+
|
|
105
|
+
- "What documents do I need for this task?"
|
|
106
|
+
- "Which skills should be loaded?"
|
|
107
|
+
- "What modules are affected by this change?"
|
|
108
|
+
- "Is this context package within budget?"
|
|
109
|
+
- "Why was this document skipped?"
|
|
110
|
+
|
|
111
|
+
|
|
112
|
+
## Code Examples
|
|
113
|
+
|
|
114
|
+
See `EXAMPLES.md` for detailed code examples.
|
|
115
|
+
|
|
116
|
+
## Validation Checklist
|
|
117
|
+
|
|
118
|
+
What to verify during the review phase before completing the task.
|
|
119
|
+
|
|
120
|
+
## Common Mistakes
|
|
121
|
+
|
|
122
|
+
Anti-patterns and things to explicitly avoid. See `TROUBLESHOOTING.md`.
|
|
123
|
+
|
|
124
|
+
## Integration Notes
|
|
125
|
+
|
|
126
|
+
How this skill interacts with other skills.
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# context-manager Troubleshooting & Common Mistakes
|
|
2
|
+
|
|
3
|
+
## 1. Token Budget Blowout
|
|
4
|
+
|
|
5
|
+
- **Symptom**: Model performance drops significantly, losing earlier conversational context.
|
|
6
|
+
- **Root Cause**: Loading large JSON mocks, lockfiles, or build directories into prompt.
|
|
7
|
+
- **Fix**: Never read package-lock.json, dist/, or build artifacts unless explicitly debugging bundle outputs.
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
name: context-manager
|
|
2
|
+
description: >
|
|
3
|
+
Smart context selection engine. Analyzes the current task, consults the
|
|
4
|
+
Project Graph, and returns only the documents and skills needed to prevent token overflow.
|
|
5
|
+
tags:
|
|
6
|
+
- context
|
|
7
|
+
- optimization
|
|
8
|
+
- tokens
|
|
9
|
+
- architecture
|
|
10
|
+
version: 1.0.0
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# context-os Examples — Anti-patterns vs ContextOS Standard
|
|
2
|
+
|
|
3
|
+
## Example 1: Project Lifecycle Management
|
|
4
|
+
|
|
5
|
+
### Anti-pattern: Ad-hoc Unstructured Development
|
|
6
|
+
|
|
7
|
+
```text
|
|
8
|
+
Coding -> Modifying DB -> Debugging -> Redesigning UI -> Changing Architecture
|
|
9
|
+
All in one unstructured stream of consciousness.
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
### Best practice: ContextOS Standard (Phase-Gated Development)
|
|
13
|
+
|
|
14
|
+
```text
|
|
15
|
+
Phase 1: DEFINE (PRD & Requirements)
|
|
16
|
+
Phase 2: PLAN (Atomic Tasks & ADRs)
|
|
17
|
+
Phase 3: BUILD (TDD & Minimalist Implementation)
|
|
18
|
+
Phase 4: VERIFY (Automated Test Proof)
|
|
19
|
+
Phase 5: REVIEW (Design QA & Code Review)
|
|
20
|
+
Phase 6: SHIP (Production Release)
|
|
21
|
+
```
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: context-os
|
|
3
|
+
description: >
|
|
4
|
+
AI Project Operating System — Context Compiler that transforms user intent
|
|
5
|
+
into minimal, relevant context for any AI agent and any task.
|
|
6
|
+
Manages the full lifecycle: Idea → Requirements → Architecture → Planning →
|
|
7
|
+
Development → Review → Release.
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# context-os
|
|
11
|
+
|
|
12
|
+
## Overview
|
|
13
|
+
|
|
14
|
+
Operating system and context orchestration layer for AI coding assistants. Standardizes software engineering workflows across requirements, architecture, atomic task planning, implementation, verification, and release.
|
|
15
|
+
|
|
16
|
+
## When to Use
|
|
17
|
+
|
|
18
|
+
Activate as the root meta-orchestrator across all development phases to ensure role consistency, quality gates, and structured execution.
|
|
19
|
+
|
|
20
|
+
## Rules & Patterns
|
|
21
|
+
|
|
22
|
+
You are the **Context Compiler**. Your job is NOT to know everything. Your job is to **assemble the minimum context** needed for the current task.
|
|
23
|
+
|
|
24
|
+
## Pipeline
|
|
25
|
+
|
|
26
|
+
When a user gives you a task, follow this pipeline:
|
|
27
|
+
|
|
28
|
+
### Stage 1: Intent Analysis
|
|
29
|
+
|
|
30
|
+
Analyze the user's prompt and determine:
|
|
31
|
+
|
|
32
|
+
```yaml
|
|
33
|
+
intent:
|
|
34
|
+
project_type: [webapp, api, mobile, cli, library, saas, crm, ecommerce]
|
|
35
|
+
industry: [healthcare, fintech, education, social, general]
|
|
36
|
+
layers:
|
|
37
|
+
frontend: true/false
|
|
38
|
+
backend: true/false
|
|
39
|
+
database: true/false
|
|
40
|
+
auth: true/false
|
|
41
|
+
ai: true/false
|
|
42
|
+
payments: true/false
|
|
43
|
+
realtime: true/false
|
|
44
|
+
scope: [new_project, feature, bugfix, refactor, architecture]
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### Stage 2: Dependency Resolution
|
|
48
|
+
|
|
49
|
+
For each required layer, load the skill graph:
|
|
50
|
+
|
|
51
|
+
1. Read `skill.yaml` from each relevant skill directory
|
|
52
|
+
2. Resolve `requires` — load mandatory dependencies
|
|
53
|
+
3. Check `conflicts` — ensure no incompatible skills are loaded
|
|
54
|
+
4. Apply `optional` — suggest but don't force
|
|
55
|
+
5. Respect project profile (if set) — apply rules from `profiles/`
|
|
56
|
+
|
|
57
|
+
**Dependency resolution example:**
|
|
58
|
+
|
|
59
|
+
```
|
|
60
|
+
Need: nextjs
|
|
61
|
+
→ requires: react, typescript
|
|
62
|
+
→ react requires: typescript (already loaded)
|
|
63
|
+
→ optional: tailwind, prisma, next-auth
|
|
64
|
+
|
|
65
|
+
Loaded: [nextjs, react, typescript]
|
|
66
|
+
Suggested: [tailwind, prisma, next-auth]
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### Stage 3: Context Compilation
|
|
70
|
+
|
|
71
|
+
Assemble context from three levels:
|
|
72
|
+
|
|
73
|
+
**Level 1 — Vision (always available):**
|
|
74
|
+
|
|
75
|
+
- `docs/PRD.md` — what are we building
|
|
76
|
+
- `docs/ROADMAP.md` — where are we going
|
|
77
|
+
- `docs/PROJECT_GRAPH.md` — project structure
|
|
78
|
+
|
|
79
|
+
**Level 2 — Architecture (load when needed):**
|
|
80
|
+
|
|
81
|
+
- `docs/ARCHITECTURE.md` — system design
|
|
82
|
+
- `docs/DATABASE.md` — data model
|
|
83
|
+
- `docs/API.md` — API contracts
|
|
84
|
+
- `docs/decisions/` — prior decisions
|
|
85
|
+
|
|
86
|
+
**Level 3 — Development (load per task):**
|
|
87
|
+
|
|
88
|
+
- Relevant skill `.md` files
|
|
89
|
+
- `docs/UI.md` — for frontend tasks
|
|
90
|
+
- `docs/TASKS.md` — current sprint
|
|
91
|
+
|
|
92
|
+
**Context Filtering Rules:**
|
|
93
|
+
See `references/context-rules.md` for the full mapping of task types to required documents.
|
|
94
|
+
|
|
95
|
+
### Stage 4: Prompt Optimization
|
|
96
|
+
|
|
97
|
+
Before sending to the AI agent:
|
|
98
|
+
|
|
99
|
+
1. Remove sections not relevant to the current task
|
|
100
|
+
2. Prioritize: current task context > architecture > vision
|
|
101
|
+
3. Include recent Decision Records that affect the current task
|
|
102
|
+
4. Add coding rules from the loaded skills
|
|
103
|
+
|
|
104
|
+
## Commands
|
|
105
|
+
|
|
106
|
+
| Command | Action |
|
|
107
|
+
| --- | --- |
|
|
108
|
+
| `ctx init` | Analyze project idea, generate all docs |
|
|
109
|
+
| `ctx plan` | Generate development plan from PRD |
|
|
110
|
+
| `ctx compile` | Compile context for a specific task |
|
|
111
|
+
| `ctx update` | Update changed documents |
|
|
112
|
+
| `ctx graph` | Show/update Project Graph |
|
|
113
|
+
| `ctx doctor` | Validate skill dependencies, check for conflicts |
|
|
114
|
+
| `ctx explain` | Explain why specific context was loaded |
|
|
115
|
+
|
|
116
|
+
## Project Initialization Flow
|
|
117
|
+
|
|
118
|
+
When user says something like "Сделай CRM для стоматологии" or "Build a Trello clone":
|
|
119
|
+
|
|
120
|
+
1. **Analyze intent** (Stage 1)
|
|
121
|
+
2. **Ask clarifying questions:**
|
|
122
|
+
- Users and roles?
|
|
123
|
+
- Tech stack preference?
|
|
124
|
+
- Mobile app needed?
|
|
125
|
+
- AI features?
|
|
126
|
+
- Authentication type?
|
|
127
|
+
- Expected load?
|
|
128
|
+
- MVP or Production?
|
|
129
|
+
3. **Select profile** (startup/enterprise/mvp/hackathon)
|
|
130
|
+
4. **Resolve skills** (Stage 2)
|
|
131
|
+
5. **Generate all documents** using `generators/` skill
|
|
132
|
+
6. **Create Project Graph** — the master map of modules → features → tasks → files → skills
|
|
133
|
+
7. **Output agent config** using `adapters/` skill
|
|
134
|
+
|
|
135
|
+
## Skill Discovery
|
|
136
|
+
|
|
137
|
+
Skills are discovered by scanning `.agents/skills/*/skill.yaml`. Each `skill.yaml` defines:
|
|
138
|
+
|
|
139
|
+
```yaml
|
|
140
|
+
id: react
|
|
141
|
+
name: React
|
|
142
|
+
category: frontend
|
|
143
|
+
tags: [frontend, spa, jsx, components]
|
|
144
|
+
requires: [typescript]
|
|
145
|
+
optional: [tailwind, next-auth, react-query]
|
|
146
|
+
conflicts: [vue, angular, svelte]
|
|
147
|
+
weight: 8
|
|
148
|
+
documents:
|
|
149
|
+
- react.md
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
The compiler builds a dependency graph from all discovered skills and resolves it for each task.
|
|
153
|
+
|
|
154
|
+
|
|
155
|
+
## Code Examples
|
|
156
|
+
|
|
157
|
+
See `EXAMPLES.md` for detailed code examples.
|
|
158
|
+
|
|
159
|
+
## Validation Checklist
|
|
160
|
+
|
|
161
|
+
What to verify during the review phase before completing the task.
|
|
162
|
+
|
|
163
|
+
## Common Mistakes
|
|
164
|
+
|
|
165
|
+
Anti-patterns and things to explicitly avoid. See `TROUBLESHOOTING.md`.
|
|
166
|
+
|
|
167
|
+
## Integration Notes
|
|
168
|
+
|
|
169
|
+
How this skill interacts with other skills.
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# context-os Troubleshooting & Common Mistakes
|
|
2
|
+
|
|
3
|
+
## 1. Stale Compiled Artifacts
|
|
4
|
+
|
|
5
|
+
- **Symptom**: Editor rules don't reflect newly updated skills.
|
|
6
|
+
- **Root Cause**: Modifying .agents/core/skills/ without recompiling exports.
|
|
7
|
+
- **Fix**: Run node .agents/ctx.js export all whenever source skills are updated.
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# Skill Packs — pre-configured skill bundles
|
|
2
|
+
# Users select a pack instead of individual skills
|
|
3
|
+
|
|
4
|
+
packs:
|
|
5
|
+
fullstack-next:
|
|
6
|
+
name: "Next.js Full-Stack"
|
|
7
|
+
description: "Full-stack web app with Next.js, React, TypeScript, Tailwind, Prisma"
|
|
8
|
+
skills: [nextjs, react, typescript, tailwind, prisma, testing, security]
|
|
9
|
+
profile: startup
|
|
10
|
+
generates: [PRD, ARCHITECTURE, DATABASE, API, UI, TASKS, PROJECT_GRAPH]
|
|
11
|
+
|
|
12
|
+
fastapi-backend:
|
|
13
|
+
name: "FastAPI Backend"
|
|
14
|
+
description: "Python backend with FastAPI, PostgreSQL, Docker"
|
|
15
|
+
skills: [fastapi, python, pydantic, postgres, docker, testing, security, rest]
|
|
16
|
+
profile: startup
|
|
17
|
+
generates: [PRD, ARCHITECTURE, DATABASE, API, TASKS, PROJECT_GRAPH]
|
|
18
|
+
|
|
19
|
+
react-spa:
|
|
20
|
+
name: "React SPA"
|
|
21
|
+
description: "Single Page Application with React, TypeScript, Tailwind"
|
|
22
|
+
skills: [react, typescript, tailwind, performance, web-accessibility, testing]
|
|
23
|
+
profile: startup
|
|
24
|
+
generates: [PRD, ARCHITECTURE, API, UI, TASKS, PROJECT_GRAPH]
|
|
25
|
+
|
|
26
|
+
nestjs-enterprise:
|
|
27
|
+
name: "NestJS Enterprise"
|
|
28
|
+
description: "Enterprise-grade Node.js backend with NestJS, DDD, full testing"
|
|
29
|
+
skills: [nestjs, typescript, node, postgres, ddd, security, testing, cicd, docker]
|
|
30
|
+
profile: enterprise
|
|
31
|
+
generates: [PRD, ARCHITECTURE, DATABASE, API, TASKS, ROADMAP, PROJECT_GRAPH]
|
|
32
|
+
|
|
33
|
+
design-system:
|
|
34
|
+
name: "Design System"
|
|
35
|
+
description: "UI/UX design system with accessibility and performance"
|
|
36
|
+
skills: [ui-design, ux-design, web-accessibility, performance]
|
|
37
|
+
profile: startup
|
|
38
|
+
generates: [PRD, UI, TASKS]
|
|
39
|
+
|
|
40
|
+
mobile-react-native:
|
|
41
|
+
name: "React Native Mobile"
|
|
42
|
+
description: "Cross-platform mobile app with React Native"
|
|
43
|
+
skills: [react, typescript, react-native, performance, web-accessibility]
|
|
44
|
+
profile: startup
|
|
45
|
+
generates: [PRD, ARCHITECTURE, API, UI, TASKS, PROJECT_GRAPH]
|
|
46
|
+
|
|
47
|
+
hackathon-fast:
|
|
48
|
+
name: "Hackathon Quick Start"
|
|
49
|
+
description: "Fastest possible setup — SQLite, minimal architecture"
|
|
50
|
+
skills: [react, typescript, node, sqlite]
|
|
51
|
+
profile: hackathon
|
|
52
|
+
generates: [TASKS, PROJECT_GRAPH]
|
|
53
|
+
|
|
54
|
+
ai-saas:
|
|
55
|
+
name: "AI SaaS Platform"
|
|
56
|
+
description: "SaaS with AI features, auth, payments, analytics"
|
|
57
|
+
skills: [nextjs, react, typescript, tailwind, prisma, security, stripe, openai]
|
|
58
|
+
profile: startup
|
|
59
|
+
generates: [PRD, ARCHITECTURE, DATABASE, API, UI, ROADMAP, TASKS, PROJECT_GRAPH]
|