@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.
Files changed (94) hide show
  1. package/.antigravity-plugin/plugin.json +34 -0
  2. package/.claude-plugin/marketplace.json +20 -0
  3. package/.claude-plugin/plugin.json +25 -0
  4. package/.codex-plugin/plugin.json +50 -0
  5. package/CLAUDE.md +94 -0
  6. package/assets/antigravity-logo.png +0 -0
  7. package/assets/app-icon.png +0 -0
  8. package/assets/superpowers-small.svg +1 -0
  9. package/hooks/hooks-cursor.json +10 -0
  10. package/hooks/hooks.json +18 -0
  11. package/hooks/run-hook.cmd +79 -0
  12. package/hooks/session-start +90 -0
  13. package/package.json +13 -2
  14. package/plugin/plugin.json +25 -14
  15. package/plugin/skills/brainstorming/SKILL.md +316 -0
  16. package/plugin/skills/brainstorming/builder-check-prompt.md +23 -0
  17. package/plugin/skills/brainstorming/scripts/frame-template.html +213 -0
  18. package/plugin/skills/brainstorming/scripts/helper.js +167 -0
  19. package/plugin/skills/brainstorming/scripts/server.cjs +723 -0
  20. package/plugin/skills/brainstorming/scripts/start-server.sh +216 -0
  21. package/plugin/skills/brainstorming/scripts/stop-server.sh +120 -0
  22. package/plugin/skills/brainstorming/visual-companion.md +299 -0
  23. package/plugin/skills/diagnosing-superpowers/SKILL.md +120 -0
  24. package/plugin/skills/diagnosing-superpowers/prompts/analyst-common.md +38 -0
  25. package/plugin/skills/diagnosing-superpowers/prompts/cost-and-time.md +28 -0
  26. package/plugin/skills/diagnosing-superpowers/prompts/plan-adherence.md +29 -0
  27. package/plugin/skills/diagnosing-superpowers/prompts/quality-evidence.md +26 -0
  28. package/plugin/skills/diagnosing-superpowers/prompts/repeated-work.md +30 -0
  29. package/plugin/skills/diagnosing-superpowers/prompts/request-conflicts.md +20 -0
  30. package/plugin/skills/diagnosing-superpowers/prompts/scrub-audit.md +33 -0
  31. package/plugin/skills/diagnosing-superpowers/prompts/scrub.md +29 -0
  32. package/plugin/skills/diagnosing-superpowers/prompts/similar-session.md +38 -0
  33. package/plugin/skills/diagnosing-superpowers/prompts/skill-timeline.md +30 -0
  34. package/plugin/skills/diagnosing-superpowers/prompts/stumbles.md +28 -0
  35. package/plugin/skills/diagnosing-superpowers/references/context-safety.md +22 -0
  36. package/plugin/skills/diagnosing-superpowers/references/github-issues.md +47 -0
  37. package/plugin/skills/diagnosing-superpowers/references/redaction-policy.md +34 -0
  38. package/plugin/skills/diagnosing-superpowers/references/session-discovery.md +31 -0
  39. package/plugin/skills/diagnosing-superpowers/templates/bundle-README.md +77 -0
  40. package/plugin/skills/diagnosing-superpowers/templates/case.md +64 -0
  41. package/plugin/skills/diagnosing-superpowers/templates/issue.md +70 -0
  42. package/plugin/skills/diagnosing-superpowers/templates/report.md +82 -0
  43. package/plugin/skills/dispatching-parallel-agents/SKILL.md +167 -0
  44. package/plugin/skills/executing-plans/SKILL.md +323 -0
  45. package/plugin/skills/executing-plans/scripts/task-done +55 -0
  46. package/plugin/skills/executing-plans/scripts/task-start +32 -0
  47. package/plugin/skills/finishing-a-development-branch/SKILL.md +225 -0
  48. package/plugin/skills/receiving-code-review/SKILL.md +205 -0
  49. package/plugin/skills/requesting-code-review/SKILL.md +95 -0
  50. package/plugin/skills/requesting-code-review/code-reviewer.md +198 -0
  51. package/plugin/skills/subagent-driven-development/SKILL.md +339 -0
  52. package/plugin/skills/subagent-driven-development/implementer-prompt.md +154 -0
  53. package/plugin/skills/subagent-driven-development/re-review-prompt.md +116 -0
  54. package/plugin/skills/subagent-driven-development/references/batching.md +11 -0
  55. package/plugin/skills/subagent-driven-development/references/cannot-verify.md +10 -0
  56. package/plugin/skills/subagent-driven-development/references/final-review.md +49 -0
  57. package/plugin/skills/subagent-driven-development/references/fix-loop.md +77 -0
  58. package/plugin/skills/subagent-driven-development/references/handling-reports.md +15 -0
  59. package/plugin/skills/subagent-driven-development/references/preflight.md +26 -0
  60. package/plugin/skills/subagent-driven-development/references/resuming.md +12 -0
  61. package/plugin/skills/subagent-driven-development/scripts/review-package +64 -0
  62. package/plugin/skills/subagent-driven-development/scripts/sdd-repo +54 -0
  63. package/plugin/skills/subagent-driven-development/scripts/sdd-workspace +110 -0
  64. package/plugin/skills/subagent-driven-development/scripts/task-brief +108 -0
  65. package/plugin/skills/subagent-driven-development/task-reviewer-prompt.md +209 -0
  66. package/plugin/skills/systematic-debugging/SKILL.md +283 -0
  67. package/plugin/skills/systematic-debugging/condition-based-waiting-example.ts +158 -0
  68. package/plugin/skills/systematic-debugging/condition-based-waiting.md +115 -0
  69. package/plugin/skills/systematic-debugging/defense-in-depth.md +122 -0
  70. package/plugin/skills/systematic-debugging/find-polluter.sh +72 -0
  71. package/plugin/skills/systematic-debugging/root-cause-tracing.md +169 -0
  72. package/plugin/skills/test-driven-development/SKILL.md +330 -0
  73. package/plugin/skills/test-driven-development/writing-good-tests.md +198 -0
  74. package/plugin/skills/using-git-worktrees/SKILL.md +167 -0
  75. package/plugin/skills/using-superpowers/SKILL.md +65 -0
  76. package/plugin/skills/using-superpowers/references/antigravity-tools.md +23 -0
  77. package/plugin/skills/using-superpowers/references/claude-code-tools.md +29 -0
  78. package/plugin/skills/using-superpowers/references/codex-tools.md +108 -0
  79. package/plugin/skills/using-superpowers/references/gemini-tools.md +63 -0
  80. package/plugin/skills/using-superpowers/references/hermes-tools.md +56 -0
  81. package/plugin/skills/using-superpowers/references/muse-tools.md +35 -0
  82. package/plugin/skills/using-superpowers/references/pi-tools.md +16 -0
  83. package/plugin/skills/verification-before-completion/SKILL.md +120 -0
  84. package/plugin/skills/writing-plans/SKILL.md +204 -0
  85. package/plugin/skills/writing-skills/SKILL.md +399 -0
  86. package/plugin/skills/writing-skills/references/CLAUDE_MD_TESTING.md +189 -0
  87. package/plugin/skills/writing-skills/references/anthropic-best-practices.md +1150 -0
  88. package/plugin/skills/writing-skills/references/bulletproofing.md +80 -0
  89. package/plugin/skills/writing-skills/references/discovery.md +201 -0
  90. package/plugin/skills/writing-skills/references/flowcharts.md +37 -0
  91. package/plugin/skills/writing-skills/references/graphviz-conventions.dot +172 -0
  92. package/plugin/skills/writing-skills/references/persuasion-principles.md +187 -0
  93. package/plugin/skills/writing-skills/references/testing-skills-with-subagents.md +384 -0
  94. 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>
@@ -0,0 +1,10 @@
1
+ {
2
+ "version": 1,
3
+ "hooks": {
4
+ "sessionStart": [
5
+ {
6
+ "command": "./hooks/run-hook.cmd session-start"
7
+ }
8
+ ]
9
+ }
10
+ }
@@ -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.6",
4
- "description": "CortexOps Multi-Agent Framework: Autonomous engineering and research operating system for Google Antigravity.",
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
  }
@@ -1,23 +1,34 @@
1
1
  {
2
2
  "name": "cortexops",
3
3
  "displayName": "CortexOps Multi-Agent Framework",
4
- "version": "1.0.0",
5
- "description": "Autonomous multi-agent engineering and scientific research operating system orchestrated with ThutaCortex second brain integration.",
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
- "keywords": [
11
- "multi-agent",
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
  }