contextos-agents 1.5.0

package/.agents/core/profiles/backend.yaml

@@ -0,0 +1,47 @@
+# Profile: Backend
+# Dedicated backend & API architecture focus
+
+id: backend
+name: Backend
+description: "Specialized for server-side architectures, APIs, databases, microservices, and system design."
+
+generate_docs:
+  - PRD
+  - ARCHITECTURE
+  - DATABASE
+  - API
+  - TASKS
+
+skip_docs:
+  - UI
+
+prefer_skills:
+  - system-design
+  - node
+  - fastapi
+  - nestjs
+  - microservices
+  - ddd
+  - security
+  - performance
+  - decisions
+  - engineering-workflow
+  - ponytail-mindset
+
+exclude_skills:
+  - ui-ux-pro
+  - impeccable-design
+  - ui-design
+  - ux-design
+  - web-accessibility
+
+enforce:
+  adr: true
+  testing: true
+  security_audit: true
+  code_review: true
+
+defaults:
+  architecture: modular-monolith-or-microservices
+  database: postgresql
+  auth: jwt

package/.agents/core/profiles/enterprise.yaml

@@ -0,0 +1,46 @@
+# Profile: Enterprise
+# Maximum rigor and documentation
+
+id: enterprise
+name: Enterprise
+description: "Full documentation, DDD, ADR, security audits, comprehensive testing."
+
+generate_docs:
+  - PRD
+  - ARCHITECTURE
+  - DATABASE
+  - API
+  - UI
+  - ROADMAP
+  - TASKS
+  - PROJECT_GRAPH
+  - DEPLOYMENT
+
+skip_docs: []  # Generate everything
+
+prefer_skills:
+  - postgres
+  - redis
+  - docker
+  - ddd
+  - microservices
+  - security
+
+exclude_skills: []  # Nothing excluded
+
+enforce:
+  adr: true                # Every decision must be recorded
+  testing: true             # Tests required, min coverage 80%
+  security_audit: true      # OWASP check on every PR
+  code_review: true         # Mandatory review
+  accessibility_audit: true # WCAG 2.1 AA compliance
+
+defaults:
+  architecture: microservices  # or modular-monolith
+  database: postgresql
+  auth: oauth2-jwt
+  hosting: kubernetes
+  orm: typeorm  # or prisma
+  monitoring: prometheus-grafana
+  logging: elk-stack
+  ci_cd: github-actions

package/.agents/core/profiles/frontend.yaml

@@ -0,0 +1,46 @@
+# Profile: Frontend
+# Dedicated frontend stack focus
+
+id: frontend
+name: Frontend
+description: "Specialized for modern frontend applications (React, Next.js, UI/UX, Design Systems, Accessibility)."
+
+generate_docs:
+  - PRD
+  - UI
+  - TASKS
+
+skip_docs:
+  - DATABASE
+  - MICROSERVICES
+
+prefer_skills:
+  - react
+  - nextjs
+  - typescript
+  - ui-ux-pro
+  - impeccable-design
+  - ui-design
+  - ux-design
+  - web-accessibility
+  - ponytail-mindset
+  - engineering-workflow
+  - gstack-roles
+
+exclude_skills:
+  - fastapi
+  - nestjs
+  - microservices
+  - ddd
+
+enforce:
+  adr: false
+  testing: true
+  accessibility_audit: true
+  code_review: true
+
+defaults:
+  architecture: frontend-spa-or-ssr
+  framework: nextjs
+  styling: tailwind-or-css
+  state: react-state

package/.agents/core/profiles/hackathon.yaml

@@ -0,0 +1,45 @@
+# Profile: Hackathon
+# 24-48 hours to ship something impressive
+
+id: hackathon
+name: Hackathon
+description: "Ship something impressive in 24-48 hours. No ceremony, just build."
+
+generate_docs:
+  - TASKS          # What to build, in order
+  - PROJECT_GRAPH  # Quick module map
+
+skip_docs:
+  - PRD
+  - ARCHITECTURE
+  - DATABASE
+  - API
+  - UI
+  - ROADMAP
+  - DEPLOYMENT
+
+prefer_skills:
+  - sqlite
+  - react
+  - typescript
+
+exclude_skills:
+  - ddd
+  - microservices
+  - kubernetes
+  - monitoring
+  - cicd
+  - security  # Sorry, security — not today
+  - testing   # Sorry, tests — not today
+
+enforce:
+  adr: false
+  testing: false
+  security_audit: false
+  code_review: false
+
+defaults:
+  architecture: single-file  # or monolith
+  database: sqlite
+  auth: none  # or simple-jwt
+  hosting: vercel

package/.agents/core/profiles/mvp.yaml

@@ -0,0 +1,43 @@
+# Profile: MVP
+# Minimum viable product — speed is everything
+
+id: mvp
+name: MVP
+description: "Ship the fastest possible working version. Cut everything non-essential."
+
+generate_docs:
+  - PRD        # Must know what to build
+  - TASKS      # Must know task order
+  - PROJECT_GRAPH  # Must know module structure
+
+skip_docs:
+  - ARCHITECTURE   # Keep it simple, decide as you go
+  - DATABASE       # Schema emerges from code (Prisma/SQLAlchemy)
+  - API            # API emerges from implementation
+  - UI             # Build directly, iterate fast
+  - ROADMAP        # No long-term planning yet
+  - DEPLOYMENT     # Deploy later
+
+prefer_skills:
+  - sqlite        # Simplest database
+  - simple-auth   # Minimal auth (email + password)
+
+exclude_skills:
+  - ddd
+  - microservices
+  - kubernetes
+  - monitoring
+  - cicd
+  - cqrs
+
+enforce:
+  adr: false
+  testing: false        # Tests are nice, but not blocking
+  security_audit: false
+  code_review: false
+
+defaults:
+  architecture: monolith
+  database: sqlite
+  auth: simple-jwt
+  hosting: vercel

package/.agents/core/profiles/startup.yaml

@@ -0,0 +1,48 @@
+# Profile: Startup
+# Balanced between speed and quality
+
+id: startup
+name: Startup
+description: "Fast iteration with reasonable quality. Ship early, learn fast."
+
+# What to generate
+generate_docs:
+  - PRD
+  - ARCHITECTURE
+  - DATABASE
+  - API
+  - UI
+  - TASKS
+  - PROJECT_GRAPH
+
+# What to skip
+skip_docs:
+  - ROADMAP  # Optional — generate on request
+  - DEPLOYMENT  # Handle later
+
+# Skill preferences
+prefer_skills:
+  - postgres
+  - redis
+  - docker
+  - jwt
+
+exclude_skills:
+  - kubernetes
+  - ddd
+  - microservices
+
+# Quality gates
+enforce:
+  adr: false            # Record decisions, but don't block on it
+  testing: true          # Tests required
+  security_audit: false  # Not mandatory at this stage
+  code_review: true      # Self-review
+
+# Architecture defaults
+defaults:
+  architecture: modular-monolith
+  database: postgresql
+  auth: jwt
+  hosting: vercel-railway
+  orm: prisma

package/.agents/core/skills/adapters/EXAMPLES.md

@@ -0,0 +1,19 @@
+# adapters Examples — Anti-patterns vs ContextOS Standard
+
+## Example 1: Multi-Agent Configuration
+
+### Anti-pattern: Manually Syncing 6 Different Rule Files
+
+```text
+Editing .cursorrules, then forgetting to update CLAUDE.md, then editing copilot-instructions.md.
+Rules diverge across teammates using different IDEs.
+```
+
+### Best practice: ContextOS Standard (Single Source of Truth)
+
+```bash
+# Edit skills once in .agents/core/skills/
+# Compile to all agents with one command:
+node .agents/ctx.js export all
+# Automatically updates .cursorrules, CLAUDE.md, copilot-instructions.md, .aider, .zed
+```

package/.agents/core/skills/adapters/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: adapters
+description: >
+  Generates agent-specific configuration files from the unified ContextOS format.
+  One internal system, multiple output formats for Claude, Gemini, Copilot, 
+  Cursor, Aider, Continue, OpenHands, and others.
+---
+
+# agent-adapters
+
+## Overview
+
+Unified cross-agent configuration engine. Translates single ContextOS source rules into optimized native formats for Claude Code (CLAUDE.md), Gemini (.agents/skills), Cursor (.cursorrules, .cursor/rules/*.mdc), GitHub Copilot, Zed, Aider, and Continue.
+
+## When to Use
+
+Activate when configuring, synchronizing, or exporting agent rules and skills across multiple IDEs and AI programming assistants.
+
+## Rules & Patterns
+
+ContextOS is agent-agnostic. This skill generates the right config format for any AI agent.
+
+## Supported Agents
+
+| Agent | Config File | Format |
+| --- | --- | --- |
+| **Gemini** | `.agents/AGENTS.md` + `.agents/skills/` | Markdown + YAML skills |
+| **Claude Code** | `CLAUDE.md` | Single markdown file |
+| **GitHub Copilot / Codex** | `AGENTS.md` (root) | Markdown |
+| **Cursor** | `.cursorrules` | Plain text rules |
+| **Aider** | `.aider.conf.yml` | YAML config |
+| **Continue** | `.continuerules` | Markdown rules |
+| **OpenHands** | `openhands.json` | JSON config |
+| **Roo Code** | `.roo/` | Directory with rules |
+| **Windsurf** | `.windsurfrules` | Plain text rules |
+
+## Generation Command
+
+`ctx adapt [agent]` — Generate config for a specific agent.
+
+`ctx adapt all` — Generate configs for all supported agents.
+
+## Adapter Logic
+
+### For Claude Code (`CLAUDE.md`)
+
+Compile into a single markdown file:
+
+1. Project overview from `docs/PRD.md` (summary only)
+2. Architecture summary from `docs/ARCHITECTURE.md`
+3. Coding rules from loaded skills
+4. Active Decision Records
+5. Current tasks from `docs/TASKS.md`
+
+### For Gemini (`.agents/AGENTS.md`)
+
+Already native format. Just ensure:
+
+1. `AGENTS.md` references the skill directory
+2. Skills have proper SKILL.md with frontmatter
+3. Context Manager rules are in AGENTS.md
+
+### For Cursor (`.cursorrules`)
+
+Compile into a flat text file:
+
+1. Project context (condensed)
+2. Coding style rules
+3. Framework-specific instructions
+4. Anti-patterns to avoid
+
+### For Aider (`.aider.conf.yml`)
+
+```yaml
+read:
+  - docs/ARCHITECTURE.md
+  - docs/API.md
+  - docs/PROJECT_GRAPH.md
+conventions:
+  - {{coding rules from skills}}
+```
+
+## Sync Rules
+
+- Adapters read from the canonical ContextOS documents
+- Never edit adapter output files directly
+- Re-run `ctx adapt` after any document change
+- Each adapter file includes a header: `# Generated by ContextOS — do not edit directly`
+
+
+## Code Examples
+
+See `EXAMPLES.md` for detailed code examples.
+
+## Validation Checklist
+
+What to verify during the review phase before completing the task.
+
+## Common Mistakes
+
+Anti-patterns and things to explicitly avoid. See `TROUBLESHOOTING.md`.
+
+## Integration Notes
+
+How this skill interacts with other skills.

package/.agents/core/skills/adapters/TROUBLESHOOTING.md

@@ -0,0 +1,7 @@
+# adapters Troubleshooting & Common Mistakes
+
+## 1. Overwriting Custom Configs
+
+- **Symptom**: Custom non-ContextOS rules wiped out during export.
+- **Root Cause**: Running export with force flags over unmanaged files.
+- **Fix**: Keep custom project overrides in dedicated config files or use plugin skills.

package/.agents/core/skills/adapters/VALIDATION.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "rules_followed": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "rules_followed"
+  ]
+}

package/.agents/core/skills/adapters/skill.yaml

@@ -0,0 +1,10 @@
+name: adapters
+description: >
+  Generates agent-specific configuration files from unified ContextOS format.
+  Produces configs for Claude, Gemini, Copilot, Cursor, Aider, Continue, and Zed.
+tags:
+  - adapters
+  - agents
+  - configuration
+  - devops
+version: 1.0.0

package/.agents/core/skills/architecture-diagrams/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: architecture-diagrams
+description: >
+  Interactive, visual architecture and sequence diagrams as code. Generates beautiful, self-contained
+  SVG/HTML diagrams with motion, clear component boundaries, and verifiable data flows.
+---
+
+# architecture-diagrams
+
+## Overview
+
+Visual architecture engineering skill inspired by [tt-a1i/archify](https://github.com/tt-a1i/archify). Replaces static ASCII art and rigid default diagrams with crisp, self-contained SVG and responsive HTML diagrams featuring modern dark-mode palettes, pulse animations for event flows, and strict C4-model component boundaries.
+
+## When to Use
+
+Activate whenever:
+
+- Designing or explaining distributed systems, microservices, or full-stack architectures.
+- Visualizing complex auth flows (OAuth2, PKCE), multi-step payment sagas, or CDC outbox data pipelines.
+- User requests an architecture diagram, flow chart, sequence diagram, or visual system design.
+
+## Rules & Patterns
+
+### 1. Diagram Types Supported
+
+1. **System Landscape / C4 Container Diagram**:
+   - Clients (Web, Mobile, Third-party) → API Gateway / CDN → Microservices / Serverless → Storage / Event Brokers.
+2. **Sequence Flow Diagram**:
+   - Step-by-step lifecycles with synchronous requests, asynchronous pub/sub events, and compensating transactions.
+3. **Data Pipeline & Event-Driven Topology**:
+   - Primary DB → Transactional Outbox → CDC (Debezium) → Kafka Topic → Consumers → Materialized Views.
+
+### 2. Aesthetic & Visual Invariants
+
+- **Dark Theme by Default**: Surface `#0B0F19`, containers `#1E293B`, borders `#334155`, text `#F8FAFC`.
+- **Semantic Component Accents**:
+  - Client / Frontend: Sky Blue (`#38BDF8`)
+  - API Gateway / Router: Indigo (`#818CF8`)
+  - Business Services: Emerald Green (`#34D399`)
+  - Databases / Storage: Amber / Orange (`#F59E0B`)
+  - Message Brokers / Event Buses: Purple (`#A855F7`)
+- **Active Data-Flow Motion**: Use subtle CSS `@keyframes` on SVG stroke dashes (`stroke-dasharray`, `stroke-dashoffset`) to show active direction of messages and data streams.
+
+---
+
+## Code Examples
+
+### Standalone Animated SVG Data-Flow Pattern
+
+```html
+<svg viewBox="0 0 800 200" xmlns="http://www.w3.org/2000/svg" class="bg-slate-950 rounded-xl p-4 w-full">
+  <defs>
+    <style>
+      .flow-line { stroke: #38BDF8; stroke-width: 2; stroke-dasharray: 6,6; animation: flow 1.5s linear infinite; }
+      @keyframes flow { to { stroke-dashoffset: -12; } }
+      .box { fill: #1E293B; stroke: #334155; stroke-width: 1.5; rx: 8; }
+      .text-title { fill: #F8FAFC; font-family: sans-serif; font-size: 14px; font-weight: 600; }
+      .text-sub { fill: #94A3B8; font-family: monospace; font-size: 11px; }
+    </style>
+  </defs>
+
+  <!-- Client Node -->
+  <rect x="30" y="70" width="160" height="60" class="box" />
+  <text x="110" y="96" text-anchor="middle" class="text-title">Next.js Client</text>
+  <text x="110" y="114" text-anchor="middle" class="text-sub">React 19 / RSC</text>
+
+  <!-- Data Flow -->
+  <line x1="190" y1="100" x2="330" y2="100" class="flow-line" />
+
+  <!-- API Gateway -->
+  <rect x="330" y="70" width="160" height="60" class="box" />
+  <text x="410" y="96" text-anchor="middle" class="text-title">API Gateway</text>
+  <text x="410" y="114" text-anchor="middle" class="text-sub">Auth & Rate Limiting</text>
+
+  <!-- Flow to Database -->
+  <line x1="490" y1="100" x2="630" y2="100" class="flow-line" />
+
+  <!-- Database -->
+  <rect x="630" y="70" width="140" height="60" class="box" />
+  <text x="700" y="96" text-anchor="middle" class="text-title">PostgreSQL</text>
+  <text x="700" y="114" text-anchor="middle" class="text-sub">Prisma / Outbox</text>
+</svg>
+```
+
+---
+
+## Validation Checklist
+
+- [ ] Diagram clearly identifies all component boundaries, ports, and protocols.
+- [ ] Visual hierarchy is unambiguous (clients on left/top, storage on right/bottom).
+- [ ] Motion/animation is purposeful and lightweight (no heavy canvas frameworks).
+- [ ] Accessible: nodes include semantic labels and readable color contrast.
+
+---
+
+## Common Mistakes
+
+- **Messy cross-overs**: Laying out 20 boxes with overlapping lines instead of grouping into clean C4 layers.
+- **Unlabeled connections**: Lines without protocol (HTTPS, gRPC, WSS) or event payload descriptions.
+- **Overwhelming detail**: Drawing internal class diagrams when the user asked for a system-level overview.
+
+---
+
+## Integration Notes
+
+- Triggers during `system-design` and `microservices` planning phases.
+- Used to generate visual architecture artifacts in Markdown walkthroughs and specs.
+- Pairs with `ui-ux-pro` for consistent aesthetic styling.

package/.agents/core/skills/architecture-diagrams/VALIDATION.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "rules_followed": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "rules_followed"
+  ]
+}

package/.agents/core/skills/architecture-diagrams/skill.yaml

@@ -0,0 +1,8 @@
+name: architecture-diagrams
+description: Interactive, visual architecture and sequence diagrams as code. Generates beautiful, self-contained SVG/HTML diagrams with motion, clear component boundaries, and verifiable data flows.
+tags:
+  - architecture
+  - diagrams
+  - system-design
+  - visualization
+version: 1.0.0