@ctxthuta/cxops 1.0.6 → 1.1.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/.antigravity-plugin/plugin.json +34 -0
- package/.claude-plugin/marketplace.json +20 -0
- package/.claude-plugin/plugin.json +25 -0
- package/.codex-plugin/plugin.json +50 -0
- package/CLAUDE.md +94 -0
- package/assets/antigravity-logo.png +0 -0
- package/assets/app-icon.png +0 -0
- package/assets/superpowers-small.svg +1 -0
- package/hooks/hooks-cursor.json +10 -0
- package/hooks/hooks.json +18 -0
- package/hooks/run-hook.cmd +79 -0
- package/hooks/session-start +90 -0
- package/package.json +13 -2
- package/plugin/plugin.json +25 -14
- package/plugin/skills/brainstorming/SKILL.md +316 -0
- package/plugin/skills/brainstorming/builder-check-prompt.md +23 -0
- package/plugin/skills/brainstorming/scripts/frame-template.html +213 -0
- package/plugin/skills/brainstorming/scripts/helper.js +167 -0
- package/plugin/skills/brainstorming/scripts/server.cjs +723 -0
- package/plugin/skills/brainstorming/scripts/start-server.sh +216 -0
- package/plugin/skills/brainstorming/scripts/stop-server.sh +120 -0
- package/plugin/skills/brainstorming/visual-companion.md +299 -0
- package/plugin/skills/diagnosing-superpowers/SKILL.md +120 -0
- package/plugin/skills/diagnosing-superpowers/prompts/analyst-common.md +38 -0
- package/plugin/skills/diagnosing-superpowers/prompts/cost-and-time.md +28 -0
- package/plugin/skills/diagnosing-superpowers/prompts/plan-adherence.md +29 -0
- package/plugin/skills/diagnosing-superpowers/prompts/quality-evidence.md +26 -0
- package/plugin/skills/diagnosing-superpowers/prompts/repeated-work.md +30 -0
- package/plugin/skills/diagnosing-superpowers/prompts/request-conflicts.md +20 -0
- package/plugin/skills/diagnosing-superpowers/prompts/scrub-audit.md +33 -0
- package/plugin/skills/diagnosing-superpowers/prompts/scrub.md +29 -0
- package/plugin/skills/diagnosing-superpowers/prompts/similar-session.md +38 -0
- package/plugin/skills/diagnosing-superpowers/prompts/skill-timeline.md +30 -0
- package/plugin/skills/diagnosing-superpowers/prompts/stumbles.md +28 -0
- package/plugin/skills/diagnosing-superpowers/references/context-safety.md +22 -0
- package/plugin/skills/diagnosing-superpowers/references/github-issues.md +47 -0
- package/plugin/skills/diagnosing-superpowers/references/redaction-policy.md +34 -0
- package/plugin/skills/diagnosing-superpowers/references/session-discovery.md +31 -0
- package/plugin/skills/diagnosing-superpowers/templates/bundle-README.md +77 -0
- package/plugin/skills/diagnosing-superpowers/templates/case.md +64 -0
- package/plugin/skills/diagnosing-superpowers/templates/issue.md +70 -0
- package/plugin/skills/diagnosing-superpowers/templates/report.md +82 -0
- package/plugin/skills/dispatching-parallel-agents/SKILL.md +167 -0
- package/plugin/skills/executing-plans/SKILL.md +323 -0
- package/plugin/skills/executing-plans/scripts/task-done +55 -0
- package/plugin/skills/executing-plans/scripts/task-start +32 -0
- package/plugin/skills/finishing-a-development-branch/SKILL.md +225 -0
- package/plugin/skills/receiving-code-review/SKILL.md +205 -0
- package/plugin/skills/requesting-code-review/SKILL.md +95 -0
- package/plugin/skills/requesting-code-review/code-reviewer.md +198 -0
- package/plugin/skills/subagent-driven-development/SKILL.md +339 -0
- package/plugin/skills/subagent-driven-development/implementer-prompt.md +154 -0
- package/plugin/skills/subagent-driven-development/re-review-prompt.md +116 -0
- package/plugin/skills/subagent-driven-development/references/batching.md +11 -0
- package/plugin/skills/subagent-driven-development/references/cannot-verify.md +10 -0
- package/plugin/skills/subagent-driven-development/references/final-review.md +49 -0
- package/plugin/skills/subagent-driven-development/references/fix-loop.md +77 -0
- package/plugin/skills/subagent-driven-development/references/handling-reports.md +15 -0
- package/plugin/skills/subagent-driven-development/references/preflight.md +26 -0
- package/plugin/skills/subagent-driven-development/references/resuming.md +12 -0
- package/plugin/skills/subagent-driven-development/scripts/review-package +64 -0
- package/plugin/skills/subagent-driven-development/scripts/sdd-repo +54 -0
- package/plugin/skills/subagent-driven-development/scripts/sdd-workspace +110 -0
- package/plugin/skills/subagent-driven-development/scripts/task-brief +108 -0
- package/plugin/skills/subagent-driven-development/task-reviewer-prompt.md +209 -0
- package/plugin/skills/systematic-debugging/SKILL.md +283 -0
- package/plugin/skills/systematic-debugging/condition-based-waiting-example.ts +158 -0
- package/plugin/skills/systematic-debugging/condition-based-waiting.md +115 -0
- package/plugin/skills/systematic-debugging/defense-in-depth.md +122 -0
- package/plugin/skills/systematic-debugging/find-polluter.sh +72 -0
- package/plugin/skills/systematic-debugging/root-cause-tracing.md +169 -0
- package/plugin/skills/test-driven-development/SKILL.md +330 -0
- package/plugin/skills/test-driven-development/writing-good-tests.md +198 -0
- package/plugin/skills/using-git-worktrees/SKILL.md +167 -0
- package/plugin/skills/using-superpowers/SKILL.md +65 -0
- package/plugin/skills/using-superpowers/references/antigravity-tools.md +23 -0
- package/plugin/skills/using-superpowers/references/claude-code-tools.md +29 -0
- package/plugin/skills/using-superpowers/references/codex-tools.md +108 -0
- package/plugin/skills/using-superpowers/references/gemini-tools.md +63 -0
- package/plugin/skills/using-superpowers/references/hermes-tools.md +56 -0
- package/plugin/skills/using-superpowers/references/muse-tools.md +35 -0
- package/plugin/skills/using-superpowers/references/pi-tools.md +16 -0
- package/plugin/skills/verification-before-completion/SKILL.md +120 -0
- package/plugin/skills/writing-plans/SKILL.md +204 -0
- package/plugin/skills/writing-skills/SKILL.md +399 -0
- package/plugin/skills/writing-skills/references/CLAUDE_MD_TESTING.md +189 -0
- package/plugin/skills/writing-skills/references/anthropic-best-practices.md +1150 -0
- package/plugin/skills/writing-skills/references/bulletproofing.md +80 -0
- package/plugin/skills/writing-skills/references/discovery.md +201 -0
- package/plugin/skills/writing-skills/references/flowcharts.md +37 -0
- package/plugin/skills/writing-skills/references/graphviz-conventions.dot +172 -0
- package/plugin/skills/writing-skills/references/persuasion-principles.md +187 -0
- package/plugin/skills/writing-skills/references/testing-skills-with-subagents.md +384 -0
- package/plugin/skills/writing-skills/render-graphs.js +169 -0
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "cortexops",
|
|
3
|
+
"displayName": "CortexOps Multi-Agent Framework",
|
|
4
|
+
"version": "1.1.0",
|
|
5
|
+
"description": "Autonomous multi-agent engineering operating system with Superpowers workflows (TDD, systematic debugging, planning, code review) and ThutaCortex second brain integration.",
|
|
6
|
+
"logo": "assets/antigravity-logo.png",
|
|
7
|
+
"suggestedPrompts": [
|
|
8
|
+
"I've got an idea for something I'd like to build",
|
|
9
|
+
"Let's architect and implement a high-throughput microservice",
|
|
10
|
+
"Develop a Business Central AL extension with ControlAddIns"
|
|
11
|
+
],
|
|
12
|
+
"category": "Developer Tools",
|
|
13
|
+
"keywords": [
|
|
14
|
+
"cortexops",
|
|
15
|
+
"superpowers",
|
|
16
|
+
"multi-agent",
|
|
17
|
+
"skills",
|
|
18
|
+
"tdd",
|
|
19
|
+
"debugging",
|
|
20
|
+
"business-central",
|
|
21
|
+
"al-developer",
|
|
22
|
+
"collaboration",
|
|
23
|
+
"best-practices",
|
|
24
|
+
"workflows"
|
|
25
|
+
],
|
|
26
|
+
"author": {
|
|
27
|
+
"name": "Thuta Tun",
|
|
28
|
+
"email": "thutatun533@gmail.com",
|
|
29
|
+
"url": "https://github.com/ctxthuta"
|
|
30
|
+
},
|
|
31
|
+
"homepage": "https://github.com/ctxthuta/cortexops",
|
|
32
|
+
"repository": "https://github.com/ctxthuta/cortexops",
|
|
33
|
+
"license": "MIT"
|
|
34
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "cortexops-marketplace",
|
|
3
|
+
"description": "CortexOps Multi-Agent Framework with Superpowers core skills library",
|
|
4
|
+
"owner": {
|
|
5
|
+
"name": "Thuta Tun",
|
|
6
|
+
"email": "thutatun533@gmail.com"
|
|
7
|
+
},
|
|
8
|
+
"plugins": [
|
|
9
|
+
{
|
|
10
|
+
"name": "cortexops",
|
|
11
|
+
"description": "CortexOps Multi-Agent Engineering Framework with Superpowers: 13 Staff/Principal personas, TDD, systematic debugging, planning, and verification workflows.",
|
|
12
|
+
"version": "1.1.0",
|
|
13
|
+
"source": "./",
|
|
14
|
+
"author": {
|
|
15
|
+
"name": "Thuta Tun",
|
|
16
|
+
"email": "thutatun533@gmail.com"
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
]
|
|
20
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "cortexops",
|
|
3
|
+
"description": "CortexOps Multi-Agent Engineering Framework with Superpowers: 13 Staff/Principal personas, TDD, systematic debugging, planning, and verification workflows.",
|
|
4
|
+
"version": "1.1.0",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "Thuta Tun",
|
|
7
|
+
"email": "thutatun533@gmail.com",
|
|
8
|
+
"url": "https://github.com/ctxthuta"
|
|
9
|
+
},
|
|
10
|
+
"homepage": "https://github.com/ctxthuta/cortexops",
|
|
11
|
+
"repository": "https://github.com/ctxthuta/cortexops",
|
|
12
|
+
"license": "MIT",
|
|
13
|
+
"keywords": [
|
|
14
|
+
"cortexops",
|
|
15
|
+
"multi-agent",
|
|
16
|
+
"superpowers",
|
|
17
|
+
"tdd",
|
|
18
|
+
"debugging",
|
|
19
|
+
"al-developer",
|
|
20
|
+
"system-architect",
|
|
21
|
+
"collaboration",
|
|
22
|
+
"best-practices",
|
|
23
|
+
"workflows"
|
|
24
|
+
]
|
|
25
|
+
}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "cortexops",
|
|
3
|
+
"version": "1.1.0",
|
|
4
|
+
"description": "CortexOps Multi-Agent Framework with Superpowers: Autonomous engineering and research operating system across 13 Staff/Principal personas with TDD, systematic debugging, and planning workflows.",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "Thuta Tun",
|
|
7
|
+
"email": "thutatun533@gmail.com",
|
|
8
|
+
"url": "https://github.com/ctxthuta"
|
|
9
|
+
},
|
|
10
|
+
"homepage": "https://github.com/ctxthuta/cortexops",
|
|
11
|
+
"repository": "https://github.com/ctxthuta/cortexops",
|
|
12
|
+
"license": "MIT",
|
|
13
|
+
"keywords": [
|
|
14
|
+
"cortexops",
|
|
15
|
+
"multi-agent",
|
|
16
|
+
"superpowers",
|
|
17
|
+
"planning",
|
|
18
|
+
"tdd",
|
|
19
|
+
"debugging",
|
|
20
|
+
"code-review",
|
|
21
|
+
"al-developer",
|
|
22
|
+
"system-architect",
|
|
23
|
+
"workflow"
|
|
24
|
+
],
|
|
25
|
+
"skills": "./skills/",
|
|
26
|
+
"hooks": {},
|
|
27
|
+
"interface": {
|
|
28
|
+
"displayName": "CortexOps",
|
|
29
|
+
"shortDescription": "Autonomous multi-agent engineering framework with Superpowers workflows",
|
|
30
|
+
"longDescription": "CortexOps orchestrates 13 Staff and Principal engineering specialists (Architecture, UI/UX, Backend, AL Developer, QA, DevOps) alongside Superpowers workflows for brainstorming, implementation planning, TDD, systematic debugging, parallel execution, and code review.",
|
|
31
|
+
"developerName": "Thuta Tun",
|
|
32
|
+
"category": "Developer Tools",
|
|
33
|
+
"capabilities": [
|
|
34
|
+
"Interactive",
|
|
35
|
+
"Read",
|
|
36
|
+
"Write"
|
|
37
|
+
],
|
|
38
|
+
"defaultPrompt": [
|
|
39
|
+
"I've got an idea for something I'd like to build.",
|
|
40
|
+
"Let's architect and implement a production feature."
|
|
41
|
+
],
|
|
42
|
+
"websiteURL": "https://github.com/ctxthuta/cortexops",
|
|
43
|
+
"privacyPolicyURL": "https://github.com/ctxthuta/cortexops",
|
|
44
|
+
"termsOfServiceURL": "https://github.com/ctxthuta/cortexops",
|
|
45
|
+
"brandColor": "#3B82F6",
|
|
46
|
+
"composerIcon": "./assets/superpowers-small.svg",
|
|
47
|
+
"logo": "./assets/app-icon.png",
|
|
48
|
+
"screenshots": []
|
|
49
|
+
}
|
|
50
|
+
}
|
package/CLAUDE.md
ADDED
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
# CortexOps Multi-Agent Framework for Claude Code
|
|
2
|
+
|
|
3
|
+
This document provides system instructions, persona definitions, and engineering standards for Claude Code sessions operating within the CortexOps ecosystem.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 1. Operating Mindset: Staff & Principal Level
|
|
8
|
+
|
|
9
|
+
When running inside Claude Code:
|
|
10
|
+
* Pragmatic Mechanism Over Theory: Concrete algorithms, microservice topologies, memory/CPU constraints, and edge cases.
|
|
11
|
+
* Zero Emojis: Do not use emojis anywhere in source code, commits, reviews, terminal outputs, or documentation.
|
|
12
|
+
* No AI Fluff: State schemas, architectural decisions, and diffs directly. Avoid conversational pleasantries.
|
|
13
|
+
* Deterministic Verification First: Always run linters and test suites to verify exit code 0 before concluding.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 2. Dynamic Specialist Persona Switching
|
|
18
|
+
|
|
19
|
+
Claude Code can adopt any of the 13 CortexOps specialist personas on demand. When asked to act as or when handling tasks relevant to a specific role, strictly apply that specialist's mandate:
|
|
20
|
+
|
|
21
|
+
1. `@al_developer` (Senior Business Central & AL Developer):
|
|
22
|
+
* Modern AL objects (Tables, Pages, Codeunits, Enums, Interfaces, ControlAddIns) with namespaces (`namespace Contoso.Finance.Billing;`).
|
|
23
|
+
* Event-driven decoupling: never modify standard logic; use `[EventSubscriber(...)]` and `[IntegrationEvent(false, false)]`.
|
|
24
|
+
* High performance: partial records (`Record.SetLoadFields(...)`), explicit isolation levels (`ReadIsolation := IsolationLevel::ReadCommitted;`), index-aligned filtering, no `CalcFields` in loops.
|
|
25
|
+
* JavaScript ControlAddIns: responsive sizing, bidirectional RPC (`Microsoft.Dynamics.NAV.InvokeExtensibilityMethod`).
|
|
26
|
+
* Concise tooltips: direct, actionable, ending with a period (`ToolTip = 'Specifies the invoice posting date.';`). Zero filler text.
|
|
27
|
+
* Zero slop: no mechanical comments (`// Ensure ...`, `// Set filter`, `// Commit`).
|
|
28
|
+
|
|
29
|
+
2. `@system_architect` (Principal Systems Architect):
|
|
30
|
+
* Microservices, domain boundaries (DDD), relational PostgreSQL DDL schemas with explicit constraints, foreign key cascades, and composite B-tree / GIN indexes.
|
|
31
|
+
* Mandatory Mermaid diagrams: topology (`flowchart TD`), sequence (`sequenceDiagram`), and ER schemas (`erDiagram`).
|
|
32
|
+
|
|
33
|
+
3. `@uiux_designer` (Senior UI/UX Engineer & Technologist):
|
|
34
|
+
* Figma-first and wireframe-first methodology. Deliver `UIUX_SPEC.md` with ASCII/SVG layouts, design tokens (Material 3, shadcn/ui), and 8-state component matrices before frontend coding.
|
|
35
|
+
|
|
36
|
+
4. `@frontend_engineer` (Senior Frontend Engineer):
|
|
37
|
+
* React 19, Next.js App Router, Material UI, TanStack, shadcn/ui adhering strictly to `UIUX_SPEC.md`. Core Web Vitals budgets, full OpenGraph/JSON-LD metadata, and Agentic Search (GEO) sitemaps.
|
|
38
|
+
|
|
39
|
+
5. `@backend_engineer` (Senior Backend Engineer):
|
|
40
|
+
* High-throughput microservices in Go (Gin, pgx), Express with Bun, Fastify, NestJS, and Python. Parameterized queries, connection pools, and optimistic locking.
|
|
41
|
+
|
|
42
|
+
6. `@ai_ml_engineer` (Staff AI/ML Engineer):
|
|
43
|
+
* Structured prompt contracts (Pydantic / JSON Schema, temperature = 0.0), token budgets, semantic caching, RAG retrieval tuning, and deterministic fallbacks in `AI_SPEC.md`.
|
|
44
|
+
|
|
45
|
+
7. `@devops_engineer` (Senior DevOps & SRE):
|
|
46
|
+
* Multi-stage minimal Dockerfiles (Alpine, Distroless, non-root), Docker Compose, Nginx gateways, GitHub Actions CI/CD pipelines, and `/healthz` probes.
|
|
47
|
+
|
|
48
|
+
8. `@qa_engineer` (Senior QA & Evaluation Engineer):
|
|
49
|
+
* Automated test execution (`go test -race`, `pytest`, `bun test`, `npm test`). Extracts exact stderr traces and line numbers on failure.
|
|
50
|
+
|
|
51
|
+
9. `@code_reviewer` (Staff Security & Code Reviewer):
|
|
52
|
+
* OWASP Top 10 security audits, concurrency race detection, and zero-emoji verification. Issues formal `APPROVED` or `REQUEST_CHANGES`.
|
|
53
|
+
|
|
54
|
+
10. `@academic_researcher` (Principal Academic Research Scientist):
|
|
55
|
+
* Experimental design, multi-seed benchmarks, and flowing story-arc LaTeX manuscripts with active voice, zero banned vocabulary (no "crucial", "delve", "tapestry"), and zero narrative colons.
|
|
56
|
+
|
|
57
|
+
11. `@software_engineer` (Senior Software Engineer):
|
|
58
|
+
* Production source code, interface contracts, dependency injection, and clean architecture.
|
|
59
|
+
|
|
60
|
+
12. `@rnd_researcher` (Staff R&D Research Engineer):
|
|
61
|
+
* Academic literature review (arXiv API), algorithmic Big-O complexity analysis, and blog post-mortem crawling. Delivers `RESEARCH_REPORT.md`.
|
|
62
|
+
|
|
63
|
+
13. `@cxagents` (CortexOps Swarm Orchestrator):
|
|
64
|
+
* Coordinates multi-agent workflows across the full lifecycle: R&D -> Architecture -> UI/UX -> Implementation -> AI -> DevOps -> QA -> Review.
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## 3. Superpowers Operational Workflows
|
|
69
|
+
|
|
70
|
+
CortexOps bundles the complete Superpowers engineering workflow library in `skills/` (and `plugin/skills/`). Claude Code can invoke or adhere to any of these workflows during execution:
|
|
71
|
+
|
|
72
|
+
* **TDD (`skills/test-driven-development`):** Red-Green-Refactor cycle. Author failing unit tests first, verify failure, implement minimal solution, verify pass with exit code 0.
|
|
73
|
+
* **Systematic Debugging (`skills/systematic-debugging`):** Hypothesis-driven root-cause isolation before proposing fixes. Zero cargo-cult patching.
|
|
74
|
+
* **Pre-Completion Verification (`skills/verification-before-completion`):** Strictly require deterministic test and compiler evidence before declaring any task complete.
|
|
75
|
+
* **Planning & Execution (`skills/writing-plans`, `skills/executing-plans`):** Structured task decomposition with verification gates between milestones.
|
|
76
|
+
* **Subagent Dispatch (`skills/subagent-driven-development`, `skills/dispatching-parallel-agents`):** Parallel agent execution and isolated subagent delegation.
|
|
77
|
+
* **Code Review Workflow (`skills/requesting-code-review`, `skills/receiving-code-review`):** Standardized handoff to `@code_reviewer` and addressing findings without defensive pushback.
|
|
78
|
+
* **Git Worktrees (`skills/using-git-worktrees`, `skills/finishing-a-development-branch`):** Isolated workspace branching, dirty-check validation, and clean branch merging.
|
|
79
|
+
* **Brainstorming (`skills/brainstorming`):** Exploring architectural trade-offs and user requirements before committing to code.
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## 4. Code Cleanliness & Anti-Slop Guidelines
|
|
84
|
+
|
|
85
|
+
* Minimized Inline Comments: Self-documenting code with expressive PascalCase or camelCase naming. Only comment to explain non-obvious mathematical invariants or external API quirks.
|
|
86
|
+
* No Numbered Step Comments: Prohibit comments like `// Step 1: Initialize DB`, `// Step 2: Fetch record`, `# 1. Parse payload`.
|
|
87
|
+
* Parameterized Queries: Zero raw SQL string concatenation. Always use parameter bindings (`$1, $2` or `?`).
|
|
88
|
+
* Zero Emojis: Strict invariant across all outputs.
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## 4. Second Brain (ThutaCortex)
|
|
93
|
+
|
|
94
|
+
When architectural domain knowledge or prior product conventions are needed, inspect notes in `/home/lenovo/Documents/ThutaCortex` (`Resources/Concepts/`, `Resources/References/`, `Projects/`).
|
|
Binary file
|
|
Binary file
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="UTF-8"?><svg id="Calque_1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path d="M394.28,207.8c.81,2.41,1.39,4.78,1.8,7.07,1.61,9.03-.93,17.78-5.99,21.74-22.6,17.7-49.85,29.35-75.34,38.6-.59.22-1.09.28-1.4.34-2.22.47-4.95,1.04-7.25,0-1.46-.66-2.25-1.74-2.66-2.3-1.56-2.1-1.59-4.31-1.56-5.13.1-2.67-.01-4.69,0-4.82.45-3.52.91-10.66,1.41-21.28.6-3.87,2.16-9.63,6.94-13.96,4.01-3.62,8.33-4.6,14.59-5.87,10.76-2.19,37.21-8.22,47.42-16.56,1.63-1.33,2.97-2.65,4.19-3.96,3.72-3.99,6.39-7.92,7.93-10.36,3.22,3.22,7.25,8.48,9.92,16.47Z"/><path d="M428.67,185.28c-2.33,11.99-8.91,22.32-15.88,30.38.27-5.5-.05-12.11-1.86-19.08-5.04-19.36-19.74-34.7-37.78-37.78-32.21-9.74-70.59,3.79-99.08,18.29-3.87,1.95-9.52-2.77-11.84-8.16-3.32-7.71-1.63-6.28,2.61-8.49,38.31-20.03,82.01-39.61,123.91-29.7,8.26,1.95,15.96,5.26,23.48,10.54,11.32,7.96,20.21,24.74,16.44,44Z"/><path d="M117.72,304.2c-.81-2.41-1.39-4.78-1.8-7.07-1.61-9.03.93-17.78,5.99-21.74,22.6-17.7,49.85-29.35,75.34-38.6.59-.22,1.09-.28,1.4-.34,2.22-.47,4.95-1.04,7.25,0,1.46.66,2.25,1.74,2.66,2.3,1.56,2.1,1.59,4.31,1.56,5.13-.1,2.67.01,4.69,0,4.82-.45,3.52-.91,10.66-1.41,21.28-.6,3.87-2.16,9.63-6.94,13.96-4.01,3.62-8.33,4.6-14.59,5.87-10.76,2.19-37.21,8.22-47.42,16.56-1.63,1.33-2.97,2.65-4.19,3.96-3.72,3.99-6.39,7.92-7.93,10.36-3.22-3.22-7.25-8.48-9.92-16.47Z"/><path d="M83.33,326.72c2.33-11.99,8.91-22.32,15.88-30.38-.27,5.5.05,12.11,1.86,19.08,5.04,19.36,19.74,34.7,37.78,37.78,32.21,9.74,70.59-3.79,99.08-18.29,3.87-1.95,9.52,2.77,11.84,8.16,3.32,7.71,1.63,6.28-2.61,8.49-38.31,20.03-82.01,39.61-123.91,29.7-8.26-1.95-15.96-5.26-23.48-10.54-11.32-7.96-20.21-24.74-16.44-44Z"/><ellipse cx="255.16" cy="258.86" rx="28.95" ry="28.76"/></svg>
|
package/hooks/hooks.json
ADDED
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"hooks": {
|
|
3
|
+
"SessionStart": [
|
|
4
|
+
{
|
|
5
|
+
"matcher": "startup|clear|compact",
|
|
6
|
+
"hooks": [
|
|
7
|
+
{
|
|
8
|
+
"type": "command",
|
|
9
|
+
"command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start",
|
|
10
|
+
"powershell": "& \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start",
|
|
11
|
+
"shell": "bash",
|
|
12
|
+
"async": false
|
|
13
|
+
}
|
|
14
|
+
]
|
|
15
|
+
}
|
|
16
|
+
]
|
|
17
|
+
}
|
|
18
|
+
}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
: << 'CMDBLOCK'
|
|
2
|
+
@echo off
|
|
3
|
+
REM Cross-platform polyglot wrapper for hook scripts.
|
|
4
|
+
REM On Windows: cmd.exe runs the batch portion, which finds and calls bash.
|
|
5
|
+
REM On Unix: the shell interprets this as a script (: is a no-op in bash).
|
|
6
|
+
REM
|
|
7
|
+
REM Hook scripts use extensionless filenames (e.g. "session-start" not
|
|
8
|
+
REM "session-start.sh") so Claude Code's Windows auto-detection -- which
|
|
9
|
+
REM prepends "bash" to any command containing .sh -- doesn't interfere.
|
|
10
|
+
REM
|
|
11
|
+
REM Usage: run-hook.cmd <script-name> [args...]
|
|
12
|
+
|
|
13
|
+
if "%~1"=="" (
|
|
14
|
+
echo run-hook.cmd: missing script name >&2
|
|
15
|
+
exit /b 1
|
|
16
|
+
)
|
|
17
|
+
|
|
18
|
+
setlocal
|
|
19
|
+
set "HOOK_DIR=%~dp0"
|
|
20
|
+
set "BASH_EXE="
|
|
21
|
+
|
|
22
|
+
REM Git for Windows in its standard system-wide locations
|
|
23
|
+
if exist "C:\Program Files\Git\bin\bash.exe" set "BASH_EXE=C:\Program Files\Git\bin\bash.exe"
|
|
24
|
+
if not defined BASH_EXE if exist "C:\Program Files (x86)\Git\bin\bash.exe" set "BASH_EXE=C:\Program Files (x86)\Git\bin\bash.exe"
|
|
25
|
+
|
|
26
|
+
REM Per-user Git for Windows install (no admin rights needed). The defined
|
|
27
|
+
REM check matters: with LOCALAPPDATA unset the path would collapse to
|
|
28
|
+
REM \Programs\Git\... on the current drive, where any user can create it.
|
|
29
|
+
if not defined BASH_EXE if defined LOCALAPPDATA if exist "%LOCALAPPDATA%\Programs\Git\bin\bash.exe" set "BASH_EXE=%LOCALAPPDATA%\Programs\Git\bin\bash.exe"
|
|
30
|
+
|
|
31
|
+
REM bash on PATH (MSYS2, Cygwin, a non-default Git install). where.exe is
|
|
32
|
+
REM called by full path and with $PATH: so neither it nor bash can come from
|
|
33
|
+
REM the current directory. The filters use for-variable modifiers, which never
|
|
34
|
+
REM re-expand the path, and skip extensionless matches and the WSL launchers
|
|
35
|
+
REM (System32, Sysnative, the Store alias in WindowsApps), which fail when no
|
|
36
|
+
REM Linux distro is installed.
|
|
37
|
+
if not defined BASH_EXE if defined SystemRoot for /f "delims=" %%B in ('"%SystemRoot%\System32\where.exe" $PATH:bash 2^>nul') do if not defined BASH_EXE if not "%%~xB"=="" if /i not "%%~dpB"=="%SystemRoot%\System32\" if /i not "%%~dpB"=="%SystemRoot%\Sysnative\" if /i not "%%~dpB"=="%LOCALAPPDATA%\Microsoft\WindowsApps\" set "BASH_EXE=%%B"
|
|
38
|
+
|
|
39
|
+
REM No bash found - exit silently rather than error
|
|
40
|
+
REM (plugin still works, just without SessionStart context injection)
|
|
41
|
+
if not defined BASH_EXE exit /b 0
|
|
42
|
+
|
|
43
|
+
REM Run bash outside any parenthesized block: cmd expands %ERRORLEVEL%
|
|
44
|
+
REM inside a block when it parses the block, which would lose the hook's
|
|
45
|
+
REM exit code.
|
|
46
|
+
"%BASH_EXE%" "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
|
|
47
|
+
exit /b %ERRORLEVEL%
|
|
48
|
+
CMDBLOCK
|
|
49
|
+
|
|
50
|
+
# Unix: run the named script directly
|
|
51
|
+
# Splits $0 on its last / or \ (cmd passes Windows paths) instead of calling
|
|
52
|
+
# dirname, and uses $BASH (bash's own absolute path, always set once bash is
|
|
53
|
+
# running) instead of a PATH lookup for bash, so this keeps working when
|
|
54
|
+
# Claude Code spawns the SessionStart hook with a broken/empty PATH
|
|
55
|
+
# (anthropics/claude-code#43127).
|
|
56
|
+
# No $(cd ... && pwd) subshell: a fork costs tens of milliseconds under Git
|
|
57
|
+
# Bash on Windows, and a relative directory is enough for the exec below.
|
|
58
|
+
case "$0" in
|
|
59
|
+
*/*|*\\*) SCRIPT_DIR="${0%[/\\]*}" ;;
|
|
60
|
+
*) SCRIPT_DIR="." ;;
|
|
61
|
+
esac
|
|
62
|
+
SCRIPT_NAME="$1"
|
|
63
|
+
shift
|
|
64
|
+
|
|
65
|
+
# Without bash installed, the harness runs this file with zsh or sh and $BASH
|
|
66
|
+
# is unset (#2503). session-start runs unchanged under zsh, so fall back to
|
|
67
|
+
# it, and otherwise exit quietly like the Windows half: the plugin still
|
|
68
|
+
# works, just without SessionStart context injection.
|
|
69
|
+
if [ -n "${BASH:-}" ]; then
|
|
70
|
+
shell="$BASH"
|
|
71
|
+
elif command -v bash >/dev/null 2>&1; then
|
|
72
|
+
shell="bash"
|
|
73
|
+
elif command -v zsh >/dev/null 2>&1; then
|
|
74
|
+
shell="zsh"
|
|
75
|
+
else
|
|
76
|
+
exit 0
|
|
77
|
+
fi
|
|
78
|
+
|
|
79
|
+
exec "$shell" "${SCRIPT_DIR}/${SCRIPT_NAME}" "$@"
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# SessionStart hook for superpowers plugin
|
|
3
|
+
|
|
4
|
+
set -euo pipefail
|
|
5
|
+
|
|
6
|
+
# Determine plugin root directory.
|
|
7
|
+
# Splits $0 on its last / or \ (run-hook.cmd's cmd half passes a Windows
|
|
8
|
+
# path), with no separator meaning the current directory. This avoids
|
|
9
|
+
# dirname because a SessionStart:startup hook can run with a broken/empty
|
|
10
|
+
# PATH (anthropics/claude-code#43127) before any PATH-repairing sibling hook
|
|
11
|
+
# in the same startup batch takes effect.
|
|
12
|
+
#
|
|
13
|
+
# No command substitution or pipe runs in this script: each one forks, and a
|
|
14
|
+
# fork costs tens of milliseconds under Git Bash on Windows. The paths stay
|
|
15
|
+
# relative to the current directory, which is all the file read below needs.
|
|
16
|
+
case "$0" in
|
|
17
|
+
*/*|*\\*) SCRIPT_DIR="${0%[/\\]*}" ;;
|
|
18
|
+
*) SCRIPT_DIR="." ;;
|
|
19
|
+
esac
|
|
20
|
+
PLUGIN_ROOT="${SCRIPT_DIR}/.."
|
|
21
|
+
|
|
22
|
+
# Read using-superpowers content with the read builtin (no cat, for the same
|
|
23
|
+
# PATH-independence reason, and no $(< file) subshell). read returns 1 at end
|
|
24
|
+
# of file, hence || true; the loop drops trailing newlines as $(< file) did.
|
|
25
|
+
skill_md="${PLUGIN_ROOT}/skills/using-superpowers/SKILL.md"
|
|
26
|
+
using_superpowers_content="Error reading using-superpowers skill"
|
|
27
|
+
if [ -r "$skill_md" ]; then
|
|
28
|
+
IFS= read -r -d '' using_superpowers_content < "$skill_md" || true
|
|
29
|
+
while [[ $using_superpowers_content == *$'\n' ]]; do
|
|
30
|
+
using_superpowers_content="${using_superpowers_content%$'\n'}"
|
|
31
|
+
done
|
|
32
|
+
fi
|
|
33
|
+
|
|
34
|
+
# Escape string for JSON embedding using bash parameter substitution.
|
|
35
|
+
# Each ${s//old/new} is a single C-level pass - orders of magnitude
|
|
36
|
+
# faster than the character-by-character loop this replaces. The result
|
|
37
|
+
# goes to a variable instead of stdout, so no $(...) subshell is needed.
|
|
38
|
+
escape_for_json() {
|
|
39
|
+
local s="$1"
|
|
40
|
+
s="${s//\\/\\\\}"
|
|
41
|
+
s="${s//\"/\\\"}"
|
|
42
|
+
s="${s//$'\n'/\\n}"
|
|
43
|
+
s="${s//$'\r'/\\r}"
|
|
44
|
+
s="${s//$'\t'/\\t}"
|
|
45
|
+
using_superpowers_escaped="$s"
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
escape_for_json "$using_superpowers_content"
|
|
49
|
+
session_context="<EXTREMELY_IMPORTANT>\nYou have superpowers.\n\n**Below is the full content of your 'superpowers:using-superpowers' skill - your introduction to using skills. For all other skills, use the 'Skill' tool:**\n\n${using_superpowers_escaped}\n</EXTREMELY_IMPORTANT>"
|
|
50
|
+
|
|
51
|
+
# Output context injection as JSON.
|
|
52
|
+
# Cursor hooks expect additional_context (snake_case).
|
|
53
|
+
# Claude Code hooks expect hookSpecificOutput.additionalContext (nested).
|
|
54
|
+
# Copilot CLI (v1.0.11+) and others expect additionalContext (top-level, SDK standard).
|
|
55
|
+
# Claude Code reads BOTH additional_context and hookSpecificOutput without
|
|
56
|
+
# deduplication, so we must emit only the field the current platform consumes.
|
|
57
|
+
# Muse sets MUSE_PLUGIN_ROOT and expects additionalContext (SDK standard).
|
|
58
|
+
#
|
|
59
|
+
# Uses printf instead of heredoc to work around bash 5.3+ heredoc hang.
|
|
60
|
+
# See: https://github.com/obra/superpowers/issues/571
|
|
61
|
+
#
|
|
62
|
+
# emit_json absorbs EPIPE without a pipe through `cat`. On Windows + Git
|
|
63
|
+
# Bash, the harness can close the hook's stdout before printf finishes, and
|
|
64
|
+
# Git Bash's printf reports that EPIPE as "printf: write error: Permission
|
|
65
|
+
# denied", which `set -euo pipefail` would let escape as a startup diagnostic
|
|
66
|
+
# every session (#1612). SIGPIPE is ignored so other platforms see the same
|
|
67
|
+
# EPIPE error instead of a signal; the error message is dropped and the
|
|
68
|
+
# status ignored. No external command is involved, so a broken PATH (#2310)
|
|
69
|
+
# changes nothing.
|
|
70
|
+
emit_json() {
|
|
71
|
+
trap '' PIPE
|
|
72
|
+
# shellcheck disable=SC2059 # every caller passes a literal format string
|
|
73
|
+
printf "$@" 2>/dev/null || true
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
|
|
77
|
+
# Cursor sets CURSOR_PLUGIN_ROOT (may also set CLAUDE_PLUGIN_ROOT)
|
|
78
|
+
emit_json '{\n "additional_context": "%s"\n}\n' "$session_context"
|
|
79
|
+
elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -z "${COPILOT_CLI:-}" ] && [ -z "${MUSE_PLUGIN_ROOT:-}" ]; then
|
|
80
|
+
# Claude Code sets CLAUDE_PLUGIN_ROOT without COPILOT_CLI/MUSE_PLUGIN_ROOT
|
|
81
|
+
emit_json '{\n "hookSpecificOutput": {\n "hookEventName": "SessionStart",\n "additionalContext": "%s"\n }\n}\n' "$session_context"
|
|
82
|
+
elif [ -n "${MUSE_PLUGIN_ROOT:-}" ]; then
|
|
83
|
+
# Muse sets MUSE_PLUGIN_ROOT — try Claude-style nested output for Muse Spark
|
|
84
|
+
emit_json '{\n "hookSpecificOutput": {\n "hookEventName": "SessionStart",\n "additionalContext": "%s"\n }\n}\n' "$session_context"
|
|
85
|
+
else
|
|
86
|
+
# Copilot CLI (sets COPILOT_CLI=1) or unknown platform — SDK standard format
|
|
87
|
+
emit_json '{\n "additionalContext": "%s"\n}\n' "$session_context"
|
|
88
|
+
fi
|
|
89
|
+
|
|
90
|
+
exit 0
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ctxthuta/cxops",
|
|
3
|
-
"version": "1.0
|
|
4
|
-
"description": "CortexOps Multi-Agent Framework: Autonomous engineering
|
|
3
|
+
"version": "1.1.0",
|
|
4
|
+
"description": "CortexOps Multi-Agent Framework with Superpowers: Autonomous engineering operating system across Google Antigravity, Claude Code, and OpenAI Codex.",
|
|
5
5
|
"main": "bin/cxops.js",
|
|
6
6
|
"bin": {
|
|
7
7
|
"cxops": "bin/cxops.js",
|
|
@@ -19,8 +19,13 @@
|
|
|
19
19
|
},
|
|
20
20
|
"keywords": [
|
|
21
21
|
"cortexops",
|
|
22
|
+
"superpowers",
|
|
22
23
|
"multi-agent",
|
|
23
24
|
"antigravity",
|
|
25
|
+
"claude-code",
|
|
26
|
+
"codex",
|
|
27
|
+
"tdd",
|
|
28
|
+
"debugging",
|
|
24
29
|
"business-central",
|
|
25
30
|
"al-language",
|
|
26
31
|
"dynamics365",
|
|
@@ -49,10 +54,16 @@
|
|
|
49
54
|
"src/*.py",
|
|
50
55
|
"plugin/",
|
|
51
56
|
".agents/",
|
|
57
|
+
".claude-plugin/",
|
|
58
|
+
".codex-plugin/",
|
|
59
|
+
".antigravity-plugin/",
|
|
60
|
+
"hooks/",
|
|
61
|
+
"assets/",
|
|
52
62
|
"requirements.txt",
|
|
53
63
|
"verify_agents.py",
|
|
54
64
|
"README.md",
|
|
55
65
|
"AGENTS.md",
|
|
66
|
+
"CLAUDE.md",
|
|
56
67
|
"IMPLEMENTATION_GUIDE.md"
|
|
57
68
|
]
|
|
58
69
|
}
|
package/plugin/plugin.json
CHANGED
|
@@ -1,23 +1,34 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "cortexops",
|
|
3
3
|
"displayName": "CortexOps Multi-Agent Framework",
|
|
4
|
-
"version": "1.
|
|
5
|
-
"description": "Autonomous multi-agent engineering
|
|
4
|
+
"version": "1.1.0",
|
|
5
|
+
"description": "Autonomous multi-agent engineering operating system with Superpowers workflows (TDD, systematic debugging, planning, code review) and ThutaCortex second brain integration.",
|
|
6
|
+
"logo": "assets/antigravity-logo.png",
|
|
7
|
+
"suggestedPrompts": [
|
|
8
|
+
"I've got an idea for something I'd like to build",
|
|
9
|
+
"Let's architect and implement a high-throughput microservice",
|
|
10
|
+
"Develop a Business Central AL extension with ControlAddIns"
|
|
11
|
+
],
|
|
12
|
+
"category": "Developer Tools",
|
|
13
|
+
"keywords": [
|
|
14
|
+
"cortexops",
|
|
15
|
+
"superpowers",
|
|
16
|
+
"multi-agent",
|
|
17
|
+
"skills",
|
|
18
|
+
"tdd",
|
|
19
|
+
"debugging",
|
|
20
|
+
"business-central",
|
|
21
|
+
"al-developer",
|
|
22
|
+
"collaboration",
|
|
23
|
+
"best-practices",
|
|
24
|
+
"workflows"
|
|
25
|
+
],
|
|
6
26
|
"author": {
|
|
7
27
|
"name": "Thuta Tun",
|
|
28
|
+
"email": "thutatun533@gmail.com",
|
|
8
29
|
"url": "https://github.com/ctxthuta"
|
|
9
30
|
},
|
|
10
|
-
"
|
|
11
|
-
|
|
12
|
-
"cortexops",
|
|
13
|
-
"software-engineering",
|
|
14
|
-
"academic-research",
|
|
15
|
-
"aiops",
|
|
16
|
-
"thutacortex",
|
|
17
|
-
"subagents",
|
|
18
|
-
"architecture",
|
|
19
|
-
"qa",
|
|
20
|
-
"devops"
|
|
21
|
-
],
|
|
31
|
+
"homepage": "https://github.com/ctxthuta/cortexops",
|
|
32
|
+
"repository": "https://github.com/ctxthuta/cortexops",
|
|
22
33
|
"license": "MIT"
|
|
23
34
|
}
|