kyro-ai 3.2.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 (140) hide show
  1. package/.claude-plugin/README.md +29 -0
  2. package/.claude-plugin/marketplace.json +52 -0
  3. package/.claude-plugin/plugin.json +40 -0
  4. package/.claude-plugin/settings.json +16 -0
  5. package/LICENSE +201 -0
  6. package/README.md +331 -0
  7. package/WORKFLOW.yaml +36 -0
  8. package/agents/orchestrator.md +393 -0
  9. package/commands/forge.md +55 -0
  10. package/commands/status.md +92 -0
  11. package/commands/wrap-up.md +85 -0
  12. package/config.json +17 -0
  13. package/contexts/init.md +64 -0
  14. package/contexts/review.md +89 -0
  15. package/contexts/sprint.md +90 -0
  16. package/dist/cli/adapters/codex.d.ts +3 -0
  17. package/dist/cli/adapters/codex.d.ts.map +1 -0
  18. package/dist/cli/adapters/codex.js +55 -0
  19. package/dist/cli/adapters/codex.js.map +1 -0
  20. package/dist/cli/adapters/command-skills.d.ts +5 -0
  21. package/dist/cli/adapters/command-skills.d.ts.map +1 -0
  22. package/dist/cli/adapters/command-skills.js +41 -0
  23. package/dist/cli/adapters/command-skills.js.map +1 -0
  24. package/dist/cli/adapters/opencode.d.ts +5 -0
  25. package/dist/cli/adapters/opencode.d.ts.map +1 -0
  26. package/dist/cli/adapters/opencode.js +41 -0
  27. package/dist/cli/adapters/opencode.js.map +1 -0
  28. package/dist/cli/adapters/registry-types.d.ts +13 -0
  29. package/dist/cli/adapters/registry-types.d.ts.map +1 -0
  30. package/dist/cli/adapters/registry-types.js +3 -0
  31. package/dist/cli/adapters/registry-types.js.map +1 -0
  32. package/dist/cli/adapters/registry.d.ts +7 -0
  33. package/dist/cli/adapters/registry.d.ts.map +1 -0
  34. package/dist/cli/adapters/registry.js +46 -0
  35. package/dist/cli/adapters/registry.js.map +1 -0
  36. package/dist/cli/app.d.ts +2 -0
  37. package/dist/cli/app.d.ts.map +1 -0
  38. package/dist/cli/app.js +46 -0
  39. package/dist/cli/app.js.map +1 -0
  40. package/dist/cli/commands/doctor.d.ts +2 -0
  41. package/dist/cli/commands/doctor.d.ts.map +1 -0
  42. package/dist/cli/commands/doctor.js +133 -0
  43. package/dist/cli/commands/doctor.js.map +1 -0
  44. package/dist/cli/commands/install.d.ts +4 -0
  45. package/dist/cli/commands/install.d.ts.map +1 -0
  46. package/dist/cli/commands/install.js +42 -0
  47. package/dist/cli/commands/install.js.map +1 -0
  48. package/dist/cli/commands/tui.d.ts +2 -0
  49. package/dist/cli/commands/tui.d.ts.map +1 -0
  50. package/dist/cli/commands/tui.js +35 -0
  51. package/dist/cli/commands/tui.js.map +1 -0
  52. package/dist/cli/commands/uninstall.d.ts +3 -0
  53. package/dist/cli/commands/uninstall.d.ts.map +1 -0
  54. package/dist/cli/commands/uninstall.js +33 -0
  55. package/dist/cli/commands/uninstall.js.map +1 -0
  56. package/dist/cli/constants.d.ts +23 -0
  57. package/dist/cli/constants.d.ts.map +1 -0
  58. package/dist/cli/constants.js +27 -0
  59. package/dist/cli/constants.js.map +1 -0
  60. package/dist/cli/fs.d.ts +12 -0
  61. package/dist/cli/fs.d.ts.map +1 -0
  62. package/dist/cli/fs.js +133 -0
  63. package/dist/cli/fs.js.map +1 -0
  64. package/dist/cli/help.d.ts +4 -0
  65. package/dist/cli/help.d.ts.map +1 -0
  66. package/dist/cli/help.js +28 -0
  67. package/dist/cli/help.js.map +1 -0
  68. package/dist/cli/install-plan.d.ts +3 -0
  69. package/dist/cli/install-plan.d.ts.map +1 -0
  70. package/dist/cli/install-plan.js +93 -0
  71. package/dist/cli/install-plan.js.map +1 -0
  72. package/dist/cli/options.d.ts +8 -0
  73. package/dist/cli/options.d.ts.map +1 -0
  74. package/dist/cli/options.js +99 -0
  75. package/dist/cli/options.js.map +1 -0
  76. package/dist/cli/state.d.ts +4 -0
  77. package/dist/cli/state.d.ts.map +1 -0
  78. package/dist/cli/state.js +13 -0
  79. package/dist/cli/state.js.map +1 -0
  80. package/dist/cli/types.d.ts +50 -0
  81. package/dist/cli/types.d.ts.map +1 -0
  82. package/dist/cli/types.js +3 -0
  83. package/dist/cli/types.js.map +1 -0
  84. package/dist/cli.d.ts +3 -0
  85. package/dist/cli.d.ts.map +1 -0
  86. package/dist/cli.js +10 -0
  87. package/dist/cli.js.map +1 -0
  88. package/dist/index.d.ts +10 -0
  89. package/dist/index.d.ts.map +1 -0
  90. package/dist/index.js +12 -0
  91. package/dist/index.js.map +1 -0
  92. package/docs/HOW-TO-USE-CODEX.md +82 -0
  93. package/docs/HOW-TO-USE-OPENCODE.md +93 -0
  94. package/docs/agent-adapters.md +152 -0
  95. package/docs/agents-reference.md +153 -0
  96. package/docs/architecture.md +159 -0
  97. package/docs/architecture.mmd +21 -0
  98. package/docs/cli.md +87 -0
  99. package/docs/commands-reference.md +138 -0
  100. package/docs/context-management.md +92 -0
  101. package/docs/getting-started.md +165 -0
  102. package/docs/harness-migration.md +95 -0
  103. package/docs/programmatic-usage.md +109 -0
  104. package/docs/rules-guide.md +216 -0
  105. package/package.json +78 -0
  106. package/rules/context-persistence.md +54 -0
  107. package/rules/estimation.md +56 -0
  108. package/rules/learning-rules.md +66 -0
  109. package/rules/quality-gates.md +65 -0
  110. package/rules/sprint-discipline.md +49 -0
  111. package/scripts/check-markdown-links.mjs +97 -0
  112. package/scripts/check-versions.mjs +46 -0
  113. package/scripts/make-cli-executable.mjs +12 -0
  114. package/settings.example.json +27 -0
  115. package/skills/qa-review/SKILL.md +660 -0
  116. package/skills/qa-review/manifest.json +41 -0
  117. package/skills/sprint-forge/SKILL.md +260 -0
  118. package/skills/sprint-forge/assets/README.md +31 -0
  119. package/skills/sprint-forge/assets/helpers/analysis-guide.md +207 -0
  120. package/skills/sprint-forge/assets/helpers/analyzer.md +83 -0
  121. package/skills/sprint-forge/assets/helpers/debt-tracker.md +122 -0
  122. package/skills/sprint-forge/assets/helpers/handoff.md +103 -0
  123. package/skills/sprint-forge/assets/helpers/learner.md +69 -0
  124. package/skills/sprint-forge/assets/helpers/metrics.md +81 -0
  125. package/skills/sprint-forge/assets/helpers/reentry-generator.md +121 -0
  126. package/skills/sprint-forge/assets/helpers/reviewer.md +71 -0
  127. package/skills/sprint-forge/assets/helpers/sprint-generator.md +145 -0
  128. package/skills/sprint-forge/assets/modes/INIT.md +204 -0
  129. package/skills/sprint-forge/assets/modes/SPRINT.md +253 -0
  130. package/skills/sprint-forge/assets/modes/STATUS.md +145 -0
  131. package/skills/sprint-forge/assets/templates/PROJECT-README.md +107 -0
  132. package/skills/sprint-forge/assets/templates/REENTRY-PROMPTS.md +132 -0
  133. package/skills/sprint-forge/assets/templates/ROADMAP.md +126 -0
  134. package/skills/sprint-forge/assets/templates/SPRINT.md +189 -0
  135. package/skills/sprint-forge/manifest.json +165 -0
  136. package/templates/split-claude-md/AGENTS.md +96 -0
  137. package/templates/split-claude-md/CLAUDE.md +67 -0
  138. package/templates/split-claude-md/COMMANDS.md +37 -0
  139. package/templates/split-claude-md/LEARNED.md +39 -0
  140. package/templates/split-claude-md/SOUL.md +107 -0
@@ -0,0 +1,29 @@
1
+ # Kyro Claude Code Adapter
2
+
3
+ This directory packages Kyro for Claude Code. Kyro itself is a portable, markdown-first workflow kit for AI coding agents; this adapter registers its commands, orchestrator, and skills in Claude Code.
4
+
5
+ ## Installation
6
+
7
+ ### Via Marketplace
8
+
9
+ ```bash
10
+ /plugin marketplace add SynapSync/kyro-ai
11
+ /plugin install kyro-ai@kyro-ai
12
+ ```
13
+
14
+ Or via CLI:
15
+
16
+ ```bash
17
+ claude plugin marketplace add SynapSync/kyro-ai
18
+ claude plugin install kyro-ai@kyro-ai
19
+ ```
20
+
21
+ ### Local Install
22
+
23
+ ```bash
24
+ claude --plugin-dir /path/to/kyro-ai
25
+ ```
26
+
27
+ ## Documentation
28
+
29
+ See the main [README](../README.md) and [agent adapters guide](../docs/agent-adapters.md) for the portable workflow contract and non-Claude setup paths.
@@ -0,0 +1,52 @@
1
+ {
2
+ "name": "kyro-ai",
3
+ "owner": {
4
+ "name": "SynapSync",
5
+ "email": "synapsync@proton.me"
6
+ },
7
+ "metadata": {
8
+ "description": "Claude Code adapter for Kyro, a portable sprint workflow kit for AI coding agents"
9
+ },
10
+ "plugins": [
11
+ {
12
+ "name": "kyro-ai",
13
+ "source": "./",
14
+ "description": "Claude Code adapter for Kyro: one orchestrator agent, 3 slash commands, 2 skills, markdown artifacts, and formal debt tracking.",
15
+ "author": {
16
+ "name": "SynapSync"
17
+ },
18
+ "homepage": "https://synapsync.dev/cognitives/kyro-ai",
19
+ "repository": "https://github.com/SynapSync/kyro-ai",
20
+ "license": "Apache-2.0",
21
+ "keywords": [
22
+ "ai-agents",
23
+ "agent-workflow",
24
+ "llm-workflow",
25
+ "agentic-development",
26
+ "markdown-workflow",
27
+ "claude-code",
28
+ "workflow",
29
+ "sprint",
30
+ "planning",
31
+ "agents",
32
+ "adaptive",
33
+ "debt-tracking",
34
+ "self-correction",
35
+ "worktrees",
36
+ "orchestration"
37
+ ],
38
+ "category": "workflow",
39
+ "tags": [
40
+ "workflow",
41
+ "sprint",
42
+ "planning",
43
+ "agents",
44
+ "commands",
45
+ "productivity",
46
+ "debt-tracking",
47
+ "self-correction",
48
+ "orchestration"
49
+ ]
50
+ }
51
+ ]
52
+ }
@@ -0,0 +1,40 @@
1
+ {
2
+ "name": "kyro-ai",
3
+ "version": "3.2.0",
4
+ "description": "Claude Code adapter for Kyro, a portable sprint workflow kit for AI coding agents",
5
+ "author": {
6
+ "name": "SynapSync",
7
+ "email": "synapsync@proton.me"
8
+ },
9
+ "homepage": "https://synapsync.dev/cognitives/kyro-ai",
10
+ "repository": "https://github.com/SynapSync/kyro-ai",
11
+ "license": "Apache-2.0",
12
+ "keywords": [
13
+ "ai-agents",
14
+ "agent-workflow",
15
+ "llm-workflow",
16
+ "agentic-development",
17
+ "markdown-workflow",
18
+ "claude-code",
19
+ "workflow",
20
+ "sprint",
21
+ "planning",
22
+ "execution",
23
+ "debt-tracking",
24
+ "roadmap",
25
+ "iterative",
26
+ "adaptive",
27
+ "agents",
28
+ "self-correction",
29
+ "worktrees",
30
+ "context-persistence"
31
+ ],
32
+ "skills": [
33
+ "./skills/sprint-forge",
34
+ "./skills/qa-review"
35
+ ],
36
+ "agents": [
37
+ "./agents/orchestrator.md"
38
+ ],
39
+ "commands": ["./commands/"]
40
+ }
@@ -0,0 +1,16 @@
1
+ {
2
+ "$schema": "https://json.schemastore.org/claude-code-settings.json",
3
+ "permissions": {
4
+ "allow": [
5
+ "Read",
6
+ "Glob",
7
+ "Grep",
8
+ "Bash(git status)",
9
+ "Bash(git diff *)",
10
+ "Bash(git log *)",
11
+ "Bash(npm run build)",
12
+ "Bash(npm run typecheck)",
13
+ "Bash(git worktree *)"
14
+ ]
15
+ }
16
+ }
package/LICENSE ADDED
@@ -0,0 +1,201 @@
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
+
7
+ 1. Definitions.
8
+
9
+ "License" shall mean the terms and conditions for use, reproduction,
10
+ and distribution as defined by Sections 1 through 9 of this document.
11
+
12
+ "Licensor" shall mean the copyright owner or entity authorized by
13
+ the copyright owner that is granting the License.
14
+
15
+ "Legal Entity" shall mean the union of the acting entity and all
16
+ other entities that control, are controlled by, or are under common
17
+ control with that entity. For the purposes of this definition,
18
+ "control" means (i) the power, direct or indirect, to cause the
19
+ direction or management of such entity, whether by contract or
20
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
+ outstanding shares, or (iii) beneficial ownership of such entity.
22
+
23
+ "You" (or "Your") shall mean an individual or Legal Entity
24
+ exercising permissions granted by this License.
25
+
26
+ "Source" form shall mean the preferred form for making modifications,
27
+ including but not limited to software source code, documentation
28
+ source, and configuration files.
29
+
30
+ "Object" form shall mean any form resulting from mechanical
31
+ transformation or translation of a Source form, including but
32
+ not limited to compiled object code, generated documentation,
33
+ and conversions to other media types.
34
+
35
+ "Work" shall mean the work of authorship, whether in Source or
36
+ Object form, made available under the License, as indicated by a
37
+ copyright notice that is included in or attached to the work
38
+ (an example is provided in the Appendix below).
39
+
40
+ "Derivative Works" shall mean any work, whether in Source or Object
41
+ form, that is based on (or derived from) the Work and for which the
42
+ editorial revisions, annotations, elaborations, or other modifications
43
+ represent, as a whole, an original work of authorship. For the purposes
44
+ of this License, Derivative Works shall not include works that remain
45
+ separable from, or merely link (or bind by name) to the interfaces of,
46
+ the Work and Derivative Works thereof.
47
+
48
+ "Contribution" shall mean any work of authorship, including
49
+ the original version of the Work and any modifications or additions
50
+ to that Work or Derivative Works thereof, that is intentionally
51
+ submitted to Licensor for inclusion in the Work by the copyright owner
52
+ or by an individual or Legal Entity authorized to submit on behalf of
53
+ the copyright owner. For the purposes of this definition, "submitted"
54
+ means any form of electronic, verbal, or written communication sent
55
+ to the Licensor or its representatives, including but not limited to
56
+ communication on electronic mailing lists, source code control systems,
57
+ and issue tracking systems that are managed by, or on behalf of, the
58
+ Licensor for the purpose of discussing and improving the Work, but
59
+ excluding communication that is conspicuously marked or otherwise
60
+ designated in writing by the copyright owner as "Not a Contribution."
61
+
62
+ "Contributor" shall mean Licensor and any individual or Legal Entity
63
+ on behalf of whom a Contribution has been received by Licensor and
64
+ subsequently incorporated within the Work.
65
+
66
+ 2. Grant of Copyright License. Subject to the terms and conditions of
67
+ this License, each Contributor hereby grants to You a perpetual,
68
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
+ copyright license to reproduce, prepare Derivative Works of,
70
+ publicly display, publicly perform, sublicense, and distribute the
71
+ Work and such Derivative Works in Source or Object form.
72
+
73
+ 3. Grant of Patent License. Subject to the terms and conditions of
74
+ this License, each Contributor hereby grants to You a perpetual,
75
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
+ (except as stated in this section) patent license to make, have made,
77
+ use, offer to sell, sell, import, and otherwise transfer the Work,
78
+ where such license applies only to those patent claims licensable
79
+ by such Contributor that are necessarily infringed by their
80
+ Contribution(s) alone or by combination of their Contribution(s)
81
+ with the Work to which such Contribution(s) was submitted. If You
82
+ institute patent litigation against any entity (including a
83
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
84
+ or a Contribution incorporated within the Work constitutes direct
85
+ or contributory patent infringement, then any patent licenses
86
+ granted to You under this License for that Work shall terminate
87
+ as of the date such litigation is filed.
88
+
89
+ 4. Redistribution. You may reproduce and distribute copies of the
90
+ Work or Derivative Works thereof in any medium, with or without
91
+ modifications, and in Source or Object form, provided that You
92
+ meet the following conditions:
93
+
94
+ (a) You must give any other recipients of the Work or
95
+ Derivative Works a copy of this License; and
96
+
97
+ (b) You must cause any modified files to carry prominent notices
98
+ stating that You changed the files; and
99
+
100
+ (c) You must retain, in the Source form of any Derivative Works
101
+ that You distribute, all copyright, patent, trademark, and
102
+ attribution notices from the Source form of the Work,
103
+ excluding those notices that do not pertain to any part of
104
+ the Derivative Works; and
105
+
106
+ (d) If the Work includes a "NOTICE" text file as part of its
107
+ distribution, then any Derivative Works that You distribute must
108
+ include a readable copy of the attribution notices contained
109
+ within such NOTICE file, excluding those notices that do not
110
+ pertain to any part of the Derivative Works, in at least one
111
+ of the following places: within a NOTICE text file distributed
112
+ as part of the Derivative Works; within the Source form or
113
+ documentation, if provided along with the Derivative Works; or,
114
+ within a display generated by the Derivative Works, if and
115
+ wherever such third-party notices normally appear. The contents
116
+ of the NOTICE file are for informational purposes only and
117
+ do not modify the License. You may add Your own attribution
118
+ notices within Derivative Works that You distribute, alongside
119
+ or as an addendum to the NOTICE text from the Work, provided
120
+ that such additional attribution notices cannot be construed
121
+ as modifying the License.
122
+
123
+ You may add Your own copyright statement to Your modifications and
124
+ may provide additional or different license terms and conditions
125
+ for use, reproduction, or distribution of Your modifications, or
126
+ for any such Derivative Works as a whole, provided Your use,
127
+ reproduction, and distribution of the Work otherwise complies with
128
+ the conditions stated in this License.
129
+
130
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
131
+ any Contribution intentionally submitted for inclusion in the Work
132
+ by You to the Licensor shall be under the terms and conditions of
133
+ this License, without any additional terms or conditions.
134
+ Notwithstanding the above, nothing herein shall supersede or modify
135
+ the terms of any separate license agreement you may have executed
136
+ with Licensor regarding such Contributions.
137
+
138
+ 6. Trademarks. This License does not grant permission to use the trade
139
+ names, trademarks, service marks, or product names of the Licensor,
140
+ except as required for reasonable and customary use in describing the
141
+ origin of the Work and reproducing the content of the NOTICE file.
142
+
143
+ 7. Disclaimer of Warranty. Unless required by applicable law or
144
+ agreed to in writing, Licensor provides the Work (and each
145
+ Contributor provides its Contributions) on an "AS IS" BASIS,
146
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
+ implied, including, without limitation, any warranties or conditions
148
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
+ PARTICULAR PURPOSE. You are solely responsible for determining the
150
+ appropriateness of using or redistributing the Work and assume any
151
+ risks associated with Your exercise of permissions under this License.
152
+
153
+ 8. Limitation of Liability. In no event and under no legal theory,
154
+ whether in tort (including negligence), contract, or otherwise,
155
+ unless required by applicable law (such as deliberate and grossly
156
+ negligent acts) or agreed to in writing, shall any Contributor be
157
+ liable to You for damages, including any direct, indirect, special,
158
+ incidental, or consequential damages of any character arising as a
159
+ result of this License or out of the use or inability to use the
160
+ Work (including but not limited to damages for loss of goodwill,
161
+ work stoppage, computer failure or malfunction, or any and all
162
+ other commercial damages or losses), even if such Contributor
163
+ has been advised of the possibility of such damages.
164
+
165
+ 9. Accepting Warranty or Additional Liability. While redistributing
166
+ the Work or Derivative Works thereof, You may choose to offer,
167
+ and charge a fee for, acceptance of support, warranty, indemnity,
168
+ or other liability obligations and/or rights consistent with this
169
+ License. However, in accepting such obligations, You may act only
170
+ on Your own behalf and on Your sole responsibility, not on behalf
171
+ of any other Contributor, and only if You agree to indemnify,
172
+ defend, and hold each Contributor harmless for any liability
173
+ incurred by, or claims asserted against, such Contributor by reason
174
+ of your accepting any such warranty or additional liability.
175
+
176
+ END OF TERMS AND CONDITIONS
177
+
178
+ APPENDIX: How to apply the Apache License to your work.
179
+
180
+ To apply the Apache License to your work, attach the following
181
+ boilerplate notice, with the fields enclosed by brackets "[]"
182
+ replaced with your own identifying information. (Don't include
183
+ the brackets!) The text should be enclosed in the appropriate
184
+ comment syntax for the file format. We also recommend that a
185
+ file or class name and description of purpose be included on the
186
+ same "printed page" as the copyright notice for easier
187
+ identification within third-party archives.
188
+
189
+ Copyright [yyyy] [name of copyright owner]
190
+
191
+ Licensed under the Apache License, Version 2.0 (the "License");
192
+ you may not use this file except in compliance with the License.
193
+ You may obtain a copy of the License at
194
+
195
+ http://www.apache.org/licenses/LICENSE-2.0
196
+
197
+ Unless required by applicable law or agreed to in writing, software
198
+ distributed under the License is distributed on an "AS IS" BASIS,
199
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
+ See the License for the specific language governing permissions and
201
+ limitations under the License.
package/README.md ADDED
@@ -0,0 +1,331 @@
1
+ <p align="center">
2
+ <h1 align="center">Kyro AI</h1>
3
+ </p>
4
+
5
+ <p align="center">
6
+ <a href="https://github.com/SynapSync/kyro-ai/stargazers"><img src="https://img.shields.io/github/stars/SynapSync/kyro-ai?style=for-the-badge&logo=github&color=D97757&labelColor=1e1e2e" alt="Stars"/></a>
7
+ <a href="https://www.npmjs.com/package/kyro-ai"><img src="https://img.shields.io/npm/v/kyro-ai?style=for-the-badge&logo=npm&color=E8926F&labelColor=1e1e2e" alt="npm"/></a>
8
+ <a href="https://github.com/SynapSync/kyro-ai/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-22c55e?style=for-the-badge&labelColor=1e1e2e" alt="License"/></a>
9
+ <a href="https://github.com/SynapSync/kyro-ai/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/SynapSync/kyro-ai/ci.yml?style=for-the-badge&logo=githubactions&logoColor=white&label=CI&labelColor=1e1e2e" alt="CI"/></a>
10
+ </p>
11
+
12
+ <p align="center">
13
+ <b>Multi-agent sprint harness for AI coding agents.</b><br/>
14
+ One install command &bull; portable markdown core &bull; command skills &bull; project-local state &bull; agent adapters
15
+ </p>
16
+
17
+ ---
18
+
19
+ ## What Kyro AI Does
20
+
21
+ Kyro AI installs a project-local workflow harness that helps AI coding agents analyze, plan, execute, review, and close software work through repeatable sprint cycles.
22
+
23
+ It is designed for teams that switch between agents and do not want every agent to relearn the workflow from a giant prompt.
24
+
25
+ Kyro gives agents:
26
+
27
+ - a **managed core** with orchestrator, command, skill, and template instructions
28
+ - **command-like skills** such as `kyro-forge`, `kyro-status`, and `kyro-wrap-up`
29
+ - **workspace state** that tracks installed adapters and future scopes
30
+ - **human-readable artifacts** for roadmaps, phase documents, debt, retros, and re-entry context
31
+ - **doctor/sync/uninstall commands** so setup can be validated instead of guessed
32
+
33
+ ---
34
+
35
+ ## Quick Start
36
+
37
+ Install Kyro AI into the current project:
38
+
39
+ ```bash
40
+ npx kyro-ai install --agent opencode,codex --scope workspace --yes
41
+ npx kyro-ai doctor
42
+ ```
43
+
44
+ Use one agent only if needed:
45
+
46
+ ```bash
47
+ npx kyro-ai install --agent opencode --scope workspace --yes
48
+ npx kyro-ai install --agent codex --scope workspace --yes
49
+ ```
50
+
51
+ After install, open your agent and invoke the installed Kyro command skill:
52
+
53
+ ```text
54
+ kyro-forge auth-refactor
55
+ ```
56
+
57
+ Other installed command skills:
58
+
59
+ ```text
60
+ kyro-status
61
+ kyro-wrap-up
62
+ ```
63
+
64
+ If the host exposes slash commands, the equivalent public command namespace is:
65
+
66
+ ```text
67
+ /kyro:forge
68
+ /kyro:status
69
+ /kyro:wrap-up
70
+ ```
71
+
72
+ ---
73
+
74
+ ## Installed Workspace Layout
75
+
76
+ A workspace install writes Kyro into `.agents/`:
77
+
78
+ ```text
79
+ .agents/
80
+ ├── kyro/
81
+ │ ├── internal/
82
+ │ │ ├── core/
83
+ │ │ │ ├── agents/
84
+ │ │ │ ├── config.json
85
+ │ │ │ └── WORKFLOW.yaml
86
+ │ │ ├── commands/
87
+ │ │ ├── skills/
88
+ │ │ │ ├── sprint-forge/
89
+ │ │ │ └── qa-review/
90
+ │ │ ├── KYRO.md
91
+ │ │ ├── kyro.json
92
+ │ │ └── manifest.json
93
+ │ └── scopes/
94
+ │ └── {scope}/
95
+ │ ├── state.json
96
+ │ ├── ROADMAP.md
97
+ │ └── phases/
98
+ └── skills/
99
+ ├── kyro-forge/SKILL.md
100
+ ├── kyro-status/SKILL.md
101
+ └── kyro-wrap-up/SKILL.md
102
+ ```
103
+
104
+ Important invariant: `kyro install` creates the root project state at `.agents/kyro/internal/kyro.json`. It does **not** create `.agents/kyro/scopes/{scope}/state.json`; scoped state belongs to future scope/forge creation.
105
+
106
+ ---
107
+
108
+ ## Who Invokes Whom
109
+
110
+ ```text
111
+ User
112
+
113
+ kyro / kyro-ai CLI
114
+
115
+ installs managed core + adapter projections
116
+
117
+ agent opens the project
118
+
119
+ agent discovers AGENTS.md and/or .agents/skills
120
+
121
+ user invokes kyro-forge / kyro-status / kyro-wrap-up
122
+
123
+ projected skill reads .agents/kyro/internal/commands/*.md
124
+
125
+ orchestrator reads .agents/kyro/internal/core/agents/orchestrator.md
126
+
127
+ sprint-forge skill assets guide the workflow
128
+
129
+ artifacts are written under .agents/kyro/scopes/{scope}/
130
+ ```
131
+
132
+ The user should not have to explain the workflow in natural language. If an agent cannot discover the installed command skills, that agent needs a better adapter.
133
+
134
+ ---
135
+
136
+ ## CLI Reference
137
+
138
+ Kyro AI exposes two equivalent bins:
139
+
140
+ ```bash
141
+ kyro
142
+ kyro-ai
143
+ ```
144
+
145
+ Commands:
146
+
147
+ | Command | Purpose |
148
+ | ---------------- | ------------------------------------------------------------------ |
149
+ | `kyro` | Open the basic interactive configuration TUI |
150
+ | `kyro install` | Install managed core and selected agent adapters |
151
+ | `kyro doctor` | Validate package health, workspace state, core files, and adapters |
152
+ | `kyro sync` | Refresh managed assets without rewriting unmanaged files |
153
+ | `kyro uninstall` | Remove managed workspace assets |
154
+
155
+ Common usage:
156
+
157
+ ```bash
158
+ kyro install --agent opencode,codex --scope workspace --yes
159
+ kyro doctor
160
+ kyro sync --agent codex --dry-run
161
+ kyro uninstall --dry-run
162
+ ```
163
+
164
+ Supported install adapters today:
165
+
166
+ | Adapter | Status | What it installs |
167
+ | ---------- | --------------------------------- | --------------------------------------------------------------------- |
168
+ | `opencode` | Implemented | `.agents/skills/kyro-*` command skill projections |
169
+ | `codex` | Implemented | `.agents/skills/kyro-*` plus a managed Kyro block in root `AGENTS.md` |
170
+ | `claude` | Planned for CLI workspace install | Claude plugin remains first-class through `.claude-plugin/` |
171
+ | `cursor` | Planned | Not installed by the CLI yet |
172
+
173
+ There is intentionally no `generic` adapter. Cross-agent instructions belong in root `AGENTS.md`; install adapters should target concrete agent capabilities.
174
+
175
+ ---
176
+
177
+ ## Core Workflow
178
+
179
+ Kyro has three stable workflow intents:
180
+
181
+ | Intent | Skill / command | What it does |
182
+ | ------- | -------------------------------- | --------------------------------------------------------------- |
183
+ | Forge | `kyro-forge` / `/kyro:forge` | Analyze, plan, execute, review, and close a sprint cycle |
184
+ | Status | `kyro-status` / `/kyro:status` | Report project progress, roadmap health, and technical debt |
185
+ | Wrap-up | `kyro-wrap-up` / `/kyro:wrap-up` | Close a session, update handoff context, and preserve learnings |
186
+
187
+ Forge follows this lifecycle:
188
+
189
+ ```text
190
+ Detect project state
191
+ → analyze codebase or scope
192
+ → build/update roadmap
193
+ → generate the next sprint
194
+ → implement task by task
195
+ → review quality and debt
196
+ → write retro, handoff, and re-entry context
197
+ ```
198
+
199
+ Kyro is intentionally sprint-by-sprint. It should not pre-generate a huge static plan and pretend reality will follow it.
200
+
201
+ ---
202
+
203
+ ## Architecture
204
+
205
+ The source package is organized around portable markdown instructions plus a small deterministic CLI:
206
+
207
+ ```text
208
+ kyro-ai/
209
+ ├── src/cli/ # installer, doctor, sync, uninstall, adapters
210
+ ├── agents/ # orchestrator instruction
211
+ ├── commands/ # forge, status, wrap-up command definitions
212
+ ├── skills/
213
+ │ ├── sprint-forge/ # main workflow skill and assets
214
+ │ └── qa-review/ # senior QA review skill
215
+ ├── docs/ # architecture, CLI, adapter, and command docs
216
+ ├── rules/ # reusable operating rules
217
+ ├── templates/ # context templates
218
+ ├── .claude-plugin/ # Claude plugin adapter packaging
219
+ ├── WORKFLOW.yaml
220
+ └── config.json
221
+ ```
222
+
223
+ Runtime contract:
224
+
225
+ | Layer | Responsibility |
226
+ | --------------- | ----------------------------------------------------------------------------- |
227
+ | CLI | Install, sync, uninstall, validate, and project managed files |
228
+ | Adapter | Translate Kyro into each agent's native/compatible instruction surface |
229
+ | Projected skill | Give the agent a short command entrypoint without duplicating lifecycle prose |
230
+ | Orchestrator | Coordinate phases, gates, review, debugging, and handoff |
231
+ | Sprint Forge skill | Define workflow modes, helpers, templates, and discipline rules |
232
+ | Artifacts | Persist roadmap, phases, debt, retros, and re-entry context in markdown |
233
+
234
+ ---
235
+
236
+ ## Claude Plugin Support
237
+
238
+ Claude remains first-class.
239
+
240
+ The Claude plugin adapter lives in `.claude-plugin/` and is shipped with the package. The CLI workspace installer does not replace the Claude plugin; it complements it for agents that need workspace-local command skills and `AGENTS.md` instructions.
241
+
242
+ Claude plugin install:
243
+
244
+ ```bash
245
+ /plugin marketplace add SynapSync/kyro-ai
246
+ /plugin install kyro-ai@kyro-ai
247
+ ```
248
+
249
+ Local plugin development:
250
+
251
+ ```bash
252
+ git clone https://github.com/SynapSync/kyro-ai.git
253
+ cd kyro-ai
254
+ npm install
255
+ npm run build
256
+ claude --plugin-dir /path/to/kyro-ai
257
+ ```
258
+
259
+ ---
260
+
261
+ ## Development
262
+
263
+ Requirements:
264
+
265
+ - Node.js 18+
266
+ - npm
267
+
268
+ Useful commands:
269
+
270
+ ```bash
271
+ npm ci
272
+ npm run check
273
+ npm run build
274
+ npm pack --dry-run
275
+ ```
276
+
277
+ `npm run check` runs:
278
+
279
+ - TypeScript typecheck
280
+ - package/plugin/workflow version validation
281
+ - relative markdown link validation
282
+
283
+ Release tags publish to npm through GitHub Actions when the tag matches `package.json.version`:
284
+
285
+ ```bash
286
+ git tag v3.2.0
287
+ git push origin v3.2.0
288
+ ```
289
+
290
+ The release workflow expects the repository secret `NPM_TOKEN`.
291
+
292
+ ---
293
+
294
+ ## Documentation
295
+
296
+ | Guide | Description |
297
+ | ------------------------------------------------ | -------------------------------------------------------- |
298
+ | [CLI](docs/cli.md) | Installer, doctor, sync, uninstall, and adapter commands |
299
+ | [Commands Reference](docs/commands-reference.md) | `/kyro:*` command semantics |
300
+ | [Architecture](docs/architecture.md) | System architecture and data flow |
301
+ | [Agent Adapters](docs/agent-adapters.md) | Adapter setup and host-specific notes |
302
+ | [Harness Migration](docs/harness-migration.md) | Direction for the multi-agent runtime |
303
+ | [Getting Started](docs/getting-started.md) | Introductory workflow guide |
304
+ | [Rules Guide](docs/rules-guide.md) | Persistent learning rules |
305
+ | [Context Management](docs/context-management.md) | Re-entry prompts and continuity strategy |
306
+ | [Programmatic Usage](docs/programmatic-usage.md) | Using Kyro instructions from custom LLM apps |
307
+
308
+ ---
309
+
310
+ ## Philosophy
311
+
312
+ 1. **Commands over prose** — users should invoke workflows, not explain them repeatedly.
313
+ 2. **Markdown remains the collaboration layer** — humans and agents can inspect the same artifacts.
314
+ 3. **The CLI owns deterministic checks** — package health should not depend on prompt discipline.
315
+ 4. **Adapters are concrete** — each supported agent gets the files it actually knows how to use.
316
+ 5. **One sprint at a time** — each cycle adapts from evidence, retro, and technical debt.
317
+ 6. **Claude stays first-class** — multi-agent support does not mean retiring the Claude plugin.
318
+
319
+ ---
320
+
321
+ <p align="center">
322
+ <br/>
323
+ <b>If this helps your AI coding workflow, star the repo so other builders can find it.</b>
324
+ <br/><br/>
325
+ <a href="https://github.com/SynapSync/kyro-ai/stargazers"><img src="https://img.shields.io/github/stars/SynapSync/kyro-ai?style=for-the-badge&logo=github&color=D97757&labelColor=1e1e2e" alt="Stars"/></a>
326
+ <br/><br/>
327
+ <a href="https://github.com/SynapSync/kyro-ai/issues">Report Issues</a> &bull;
328
+ <a href="https://synapsync.dev">SynapSync</a>
329
+ <br/><br/>
330
+ <sub>Built by <a href="https://github.com/SynapSync">SynapSync</a> — a practical harness for multi-agent software delivery.</sub>
331
+ </p>