@jaguilar87/gaia-ops 1.0.3 → 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/README.en.md +223 -0
- package/README.md +96 -95
- package/package.json +2 -1
- package/speckit/README.md +2 -0
package/README.en.md
ADDED
|
@@ -0,0 +1,223 @@
|
|
|
1
|
+
# @jaguilar87/gaia-ops
|
|
2
|
+
|
|
3
|
+
**[🇪🇸 Versión en español](README.md)**
|
|
4
|
+
|
|
5
|
+
Multi-agent orchestration system for Claude Code - DevOps automation toolkit.
|
|
6
|
+
|
|
7
|
+
## Overview
|
|
8
|
+
|
|
9
|
+
**Gaia-Ops** provides a complete agent orchestration system for Claude Code, enabling intelligent automation of DevOps workflows through specialized AI agents.
|
|
10
|
+
|
|
11
|
+
### Features
|
|
12
|
+
|
|
13
|
+
- **6 specialist agents** (terraform-architect, gitops-operator, gcp-troubleshooter, aws-troubleshooter, devops-developer, claude-architect)
|
|
14
|
+
- **3 meta-agents** (Explore, Plan, claude-architect)
|
|
15
|
+
- **Clarification engine** for ambiguity detection
|
|
16
|
+
- **Approval gates** for T3 operations (terraform apply, kubectl apply, etc.)
|
|
17
|
+
- **Git commit validation** with Conventional Commits
|
|
18
|
+
- **Context provisioning** system for intelligent agent routing
|
|
19
|
+
- **Complete documentation** (orchestration workflow, git standards, agent catalog)
|
|
20
|
+
|
|
21
|
+
## Installation
|
|
22
|
+
|
|
23
|
+
### Quick Start (Recommended)
|
|
24
|
+
|
|
25
|
+
Use the built-in interactive installer to set up Gaia-Ops in any project:
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
npx @jaguilar87/gaia-ops init
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Or if installed globally:
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
npm install -g @jaguilar87/gaia-ops
|
|
35
|
+
gaia-init
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
This will:
|
|
39
|
+
1. Auto-detect your project structure (GitOps, Terraform, AppServices)
|
|
40
|
+
2. Ask you a few questions about your project
|
|
41
|
+
3. Install Claude Code if not present
|
|
42
|
+
4. Create `.claude/` directory with symlinks to this package
|
|
43
|
+
5. Generate `CLAUDE.md` with correct paths
|
|
44
|
+
6. Generate `AGENTS.md` symlink
|
|
45
|
+
7. Create `project-context.json` with your configuration
|
|
46
|
+
|
|
47
|
+
### Manual Installation
|
|
48
|
+
|
|
49
|
+
If you prefer manual setup:
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
npm install @jaguilar87/gaia-ops
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Then create symlinks:
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
mkdir -p .claude
|
|
59
|
+
cd .claude
|
|
60
|
+
ln -s ../node_modules/@jaguilar87/gaia-ops/agents agents
|
|
61
|
+
ln -s ../node_modules/@jaguilar87/gaia-ops/tools tools
|
|
62
|
+
ln -s ../node_modules/@jaguilar87/gaia-ops/hooks hooks
|
|
63
|
+
ln -s ../node_modules/@jaguilar87/gaia-ops/commands commands
|
|
64
|
+
ln -s ../node_modules/@jaguilar87/gaia-ops/templates templates
|
|
65
|
+
ln -s ../node_modules/@jaguilar87/gaia-ops/config config
|
|
66
|
+
ln -s ../node_modules/@jaguilar87/gaia-ops/CHANGELOG.md CHANGELOG.md
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## Usage
|
|
70
|
+
|
|
71
|
+
Once installed, the agent system is ready to use with Claude Code:
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
claude-code
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
Claude Code will automatically load `CLAUDE.md` and have access to all agents via the `.claude/` directory.
|
|
78
|
+
|
|
79
|
+
## Project Structure
|
|
80
|
+
|
|
81
|
+
```
|
|
82
|
+
node_modules/@jaguilar87/gaia-ops/
|
|
83
|
+
├── agents/ # Agent definitions
|
|
84
|
+
│ ├── terraform-architect.md
|
|
85
|
+
│ ├── gitops-operator.md
|
|
86
|
+
│ ├── gcp-troubleshooter.md
|
|
87
|
+
│ ├── aws-troubleshooter.md
|
|
88
|
+
│ ├── devops-developer.md
|
|
89
|
+
│ └── claude-architect.md
|
|
90
|
+
├── tools/ # Orchestration tools
|
|
91
|
+
│ ├── context_provider.py
|
|
92
|
+
│ ├── agent_router.py
|
|
93
|
+
│ ├── clarify_engine.py
|
|
94
|
+
│ ├── approval_gate.py
|
|
95
|
+
│ ├── commit_validator.py
|
|
96
|
+
│ └── task_manager.py
|
|
97
|
+
├── hooks/ # Git hooks
|
|
98
|
+
│ └── pre-commit
|
|
99
|
+
├── commands/ # Slash commands
|
|
100
|
+
│ ├── architect.md
|
|
101
|
+
│ └── speckit.*.md
|
|
102
|
+
├── config/ # Configuration & documentation
|
|
103
|
+
│ ├── AGENTS.md
|
|
104
|
+
│ ├── orchestration-workflow.md
|
|
105
|
+
│ ├── git-standards.md
|
|
106
|
+
│ ├── context-contracts.md
|
|
107
|
+
│ ├── agent-catalog.md
|
|
108
|
+
│ └── git_standards.json
|
|
109
|
+
├── templates/ # Code templates
|
|
110
|
+
│ ├── CLAUDE.template.md
|
|
111
|
+
│ └── code-examples/
|
|
112
|
+
│ ├── commit_validation.py
|
|
113
|
+
│ ├── clarification_workflow.py
|
|
114
|
+
│ └── approval_gate_workflow.py
|
|
115
|
+
├── config/ # Configuration
|
|
116
|
+
│ └── git_standards.json
|
|
117
|
+
├── CLAUDE.md # Core orchestrator instructions
|
|
118
|
+
├── AGENTS.md # System overview
|
|
119
|
+
├── CHANGELOG.md # Version history
|
|
120
|
+
├── package.json
|
|
121
|
+
└── index.js # Helper functions
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
## Your Project Structure
|
|
125
|
+
|
|
126
|
+
After installation:
|
|
127
|
+
|
|
128
|
+
```
|
|
129
|
+
your-project/
|
|
130
|
+
├── .claude/ # Symlinked to node_modules/@aaxis/claude-agents/
|
|
131
|
+
│ ├── agents/ → node_modules/@aaxis/claude-agents/agents/
|
|
132
|
+
│ ├── tools/ → node_modules/@aaxis/claude-agents/tools/
|
|
133
|
+
│ ├── hooks/ → node_modules/@aaxis/claude-agents/hooks/
|
|
134
|
+
│ ├── commands/ → node_modules/@aaxis/claude-agents/commands/
|
|
135
|
+
│ ├── docs/ → node_modules/@aaxis/claude-agents/docs/
|
|
136
|
+
│ ├── templates/ → node_modules/@aaxis/claude-agents/templates/
|
|
137
|
+
│ ├── config/ → node_modules/@aaxis/claude-agents/config/
|
|
138
|
+
│ ├── CHANGELOG.md → node_modules/@aaxis/claude-agents/CHANGELOG.md
|
|
139
|
+
│ ├── logs/ # Project-specific (NOT symlinked)
|
|
140
|
+
│ ├── tests/ # Project-specific (NOT symlinked)
|
|
141
|
+
│ └── project-context.json # Project-specific (NOT symlinked)
|
|
142
|
+
├── CLAUDE.md # Generated from template
|
|
143
|
+
├── AGENTS.md → node_modules/@aaxis/claude-agents/AGENTS.md
|
|
144
|
+
├── gitops/ # Your GitOps manifests
|
|
145
|
+
├── terraform/ # Your Terraform code
|
|
146
|
+
├── app-services/ # Your application code
|
|
147
|
+
├── node_modules/
|
|
148
|
+
│ └── @aaxis/
|
|
149
|
+
│ └── claude-agents/ # This package
|
|
150
|
+
└── package.json
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
## API
|
|
154
|
+
|
|
155
|
+
If you need to programmatically access paths in the package:
|
|
156
|
+
|
|
157
|
+
```javascript
|
|
158
|
+
import {
|
|
159
|
+
getAgentPath,
|
|
160
|
+
getToolPath,
|
|
161
|
+
getDocPath
|
|
162
|
+
} from '@aaxis/claude-agents';
|
|
163
|
+
|
|
164
|
+
const agentPath = getAgentPath('gitops-operator');
|
|
165
|
+
// → /path/to/node_modules/@aaxis/claude-agents/agents/gitops-operator.md
|
|
166
|
+
|
|
167
|
+
const toolPath = getToolPath('context_provider.py');
|
|
168
|
+
// → /path/to/node_modules/@aaxis/claude-agents/tools/context_provider.py
|
|
169
|
+
|
|
170
|
+
const docPath = getDocPath('orchestration-workflow.md');
|
|
171
|
+
// → /path/to/node_modules/@aaxis/claude-agents/docs/orchestration-workflow.md
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
## Versioning
|
|
175
|
+
|
|
176
|
+
This package follows [Semantic Versioning](https://semver.org/):
|
|
177
|
+
|
|
178
|
+
- **MAJOR:** Breaking changes to orchestrator behavior
|
|
179
|
+
- **MINOR:** New features, agents, or improvements
|
|
180
|
+
- **PATCH:** Bug fixes, clarifications, typos
|
|
181
|
+
|
|
182
|
+
Current version: **2.1.0**
|
|
183
|
+
|
|
184
|
+
See [CHANGELOG.md](./CHANGELOG.md) for version history.
|
|
185
|
+
|
|
186
|
+
## Documentation
|
|
187
|
+
|
|
188
|
+
- **Core Instructions:** [CLAUDE.md](./CLAUDE.md) (154 lines)
|
|
189
|
+
- **System Overview:** [AGENTS.md](./AGENTS.md) (95 lines)
|
|
190
|
+
- **Orchestration Workflow:** [docs/orchestration-workflow.md](./docs/orchestration-workflow.md) (735 lines)
|
|
191
|
+
- **Git Standards:** [docs/git-standards.md](./docs/git-standards.md) (682 lines)
|
|
192
|
+
- **Context Contracts:** [docs/context-contracts.md](./docs/context-contracts.md) (673 lines)
|
|
193
|
+
- **Agent Catalog:** [docs/agent-catalog.md](./docs/agent-catalog.md) (603 lines)
|
|
194
|
+
|
|
195
|
+
## Requirements
|
|
196
|
+
|
|
197
|
+
- **Node.js:** >=18.0.0
|
|
198
|
+
- **Python:** >=3.9
|
|
199
|
+
- **Claude Code:** Latest version
|
|
200
|
+
- **Git:** >=2.30
|
|
201
|
+
|
|
202
|
+
## Project Context Management
|
|
203
|
+
|
|
204
|
+
Gaia-Ops uses a versioned project context for SSOT. After installation, clone your project context:
|
|
205
|
+
|
|
206
|
+
```bash
|
|
207
|
+
cd .claude
|
|
208
|
+
git clone git@bitbucket.org:yourorg/your-project-context.git project-context
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
This keeps `project-context.json` versioned separately, while `session/` data remains local.
|
|
212
|
+
|
|
213
|
+
See [rnd-project-context](https://bitbucket.org/aaxisdigital/rnd-project-context) for an example.
|
|
214
|
+
|
|
215
|
+
## Support
|
|
216
|
+
|
|
217
|
+
- **Issues:** [GitHub Issues](https://github.com/metraton/gaia-ops/issues)
|
|
218
|
+
- **Repository:** [github.com/metraton/gaia-ops](https://github.com/metraton/gaia-ops)
|
|
219
|
+
- **Author:** Jorge Aguilar <jaguilar1897@gmail.com>
|
|
220
|
+
|
|
221
|
+
## License
|
|
222
|
+
|
|
223
|
+
MIT License - See [LICENSE](./LICENSE) for details.
|
package/README.md
CHANGED
|
@@ -1,56 +1,58 @@
|
|
|
1
1
|
# @jaguilar87/gaia-ops
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**[🇺🇸 English version](README.en.md)**
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Sistema de orquestación multi-agente para Claude Code - Toolkit de automatización DevOps.
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
## Descripción General
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
**Gaia-Ops** proporciona un sistema completo de orquestación de agentes para Claude Code, habilitando automatización inteligente de workflows DevOps a través de agentes IA especializados.
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
- **3 meta-agents** (Explore, Plan, claude-architect)
|
|
13
|
-
- **Clarification engine** for ambiguity detection
|
|
14
|
-
- **Approval gates** for T3 operations (terraform apply, kubectl apply, etc.)
|
|
15
|
-
- **Git commit validation** with Conventional Commits
|
|
16
|
-
- **Context provisioning** system for intelligent agent routing
|
|
17
|
-
- **Complete documentation** (orchestration workflow, git standards, agent catalog)
|
|
11
|
+
### Características
|
|
18
12
|
|
|
19
|
-
|
|
13
|
+
- **6 agentes especialistas** (terraform-architect, gitops-operator, gcp-troubleshooter, aws-troubleshooter, devops-developer, claude-architect)
|
|
14
|
+
- **3 meta-agentes** (Explore, Plan, claude-architect)
|
|
15
|
+
- **Motor de clarificación** para detección de ambigüedades
|
|
16
|
+
- **Puertas de aprobación** para operaciones T3 (terraform apply, kubectl apply, etc.)
|
|
17
|
+
- **Validación de commits Git** con Conventional Commits
|
|
18
|
+
- **Sistema de provisión de contexto** para ruteo inteligente de agentes
|
|
19
|
+
- **Documentación completa** (workflow de orquestación, estándares git, catálogo de agentes)
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
## Instalación
|
|
22
22
|
|
|
23
|
-
|
|
23
|
+
### Inicio Rápido (Recomendado)
|
|
24
|
+
|
|
25
|
+
Usa el instalador interactivo integrado para configurar Gaia-Ops en cualquier proyecto:
|
|
24
26
|
|
|
25
27
|
```bash
|
|
26
28
|
npx @jaguilar87/gaia-ops init
|
|
27
29
|
```
|
|
28
30
|
|
|
29
|
-
|
|
31
|
+
O si lo instalas globalmente:
|
|
30
32
|
|
|
31
33
|
```bash
|
|
32
34
|
npm install -g @jaguilar87/gaia-ops
|
|
33
35
|
gaia-init
|
|
34
36
|
```
|
|
35
37
|
|
|
36
|
-
|
|
37
|
-
1. Auto-
|
|
38
|
-
2.
|
|
39
|
-
3.
|
|
40
|
-
4.
|
|
41
|
-
5.
|
|
42
|
-
6.
|
|
43
|
-
7.
|
|
38
|
+
Esto hará:
|
|
39
|
+
1. Auto-detectar tu estructura de proyecto (GitOps, Terraform, AppServices)
|
|
40
|
+
2. Hacerte algunas preguntas sobre tu proyecto
|
|
41
|
+
3. Instalar Claude Code si no está presente
|
|
42
|
+
4. Crear directorio `.claude/` con symlinks a este paquete
|
|
43
|
+
5. Generar `CLAUDE.md` con las rutas correctas
|
|
44
|
+
6. Generar symlink `AGENTS.md`
|
|
45
|
+
7. Crear `project-context.json` con tu configuración
|
|
44
46
|
|
|
45
|
-
### Manual
|
|
47
|
+
### Instalación Manual
|
|
46
48
|
|
|
47
|
-
|
|
49
|
+
Si prefieres configuración manual:
|
|
48
50
|
|
|
49
51
|
```bash
|
|
50
52
|
npm install @jaguilar87/gaia-ops
|
|
51
53
|
```
|
|
52
54
|
|
|
53
|
-
|
|
55
|
+
Luego crea los symlinks:
|
|
54
56
|
|
|
55
57
|
```bash
|
|
56
58
|
mkdir -p .claude
|
|
@@ -64,28 +66,28 @@ ln -s ../node_modules/@jaguilar87/gaia-ops/config config
|
|
|
64
66
|
ln -s ../node_modules/@jaguilar87/gaia-ops/CHANGELOG.md CHANGELOG.md
|
|
65
67
|
```
|
|
66
68
|
|
|
67
|
-
##
|
|
69
|
+
## Uso
|
|
68
70
|
|
|
69
|
-
|
|
71
|
+
Una vez instalado, el sistema de agentes está listo para usar con Claude Code:
|
|
70
72
|
|
|
71
73
|
```bash
|
|
72
74
|
claude-code
|
|
73
75
|
```
|
|
74
76
|
|
|
75
|
-
Claude Code
|
|
77
|
+
Claude Code cargará automáticamente `CLAUDE.md` y tendrá acceso a todos los agentes vía el directorio `.claude/`.
|
|
76
78
|
|
|
77
|
-
##
|
|
79
|
+
## Estructura del Proyecto
|
|
78
80
|
|
|
79
81
|
```
|
|
80
82
|
node_modules/@jaguilar87/gaia-ops/
|
|
81
|
-
├── agents/ #
|
|
83
|
+
├── agents/ # Definiciones de agentes
|
|
82
84
|
│ ├── terraform-architect.md
|
|
83
85
|
│ ├── gitops-operator.md
|
|
84
86
|
│ ├── gcp-troubleshooter.md
|
|
85
87
|
│ ├── aws-troubleshooter.md
|
|
86
88
|
│ ├── devops-developer.md
|
|
87
89
|
│ └── claude-architect.md
|
|
88
|
-
├── tools/ #
|
|
90
|
+
├── tools/ # Herramientas de orquestación
|
|
89
91
|
│ ├── context_provider.py
|
|
90
92
|
│ ├── agent_router.py
|
|
91
93
|
│ ├── clarify_engine.py
|
|
@@ -94,128 +96,127 @@ node_modules/@jaguilar87/gaia-ops/
|
|
|
94
96
|
│ └── task_manager.py
|
|
95
97
|
├── hooks/ # Git hooks
|
|
96
98
|
│ └── pre-commit
|
|
97
|
-
├── commands/ #
|
|
99
|
+
├── commands/ # Comandos slash
|
|
98
100
|
│ ├── architect.md
|
|
99
101
|
│ └── speckit.*.md
|
|
100
|
-
├── config/ #
|
|
102
|
+
├── config/ # Configuración y documentación
|
|
101
103
|
│ ├── AGENTS.md
|
|
102
104
|
│ ├── orchestration-workflow.md
|
|
103
105
|
│ ├── git-standards.md
|
|
104
106
|
│ ├── context-contracts.md
|
|
105
107
|
│ ├── agent-catalog.md
|
|
106
108
|
│ └── git_standards.json
|
|
107
|
-
├── templates/ #
|
|
109
|
+
├── templates/ # Plantillas de código
|
|
108
110
|
│ ├── CLAUDE.template.md
|
|
109
111
|
│ └── code-examples/
|
|
110
112
|
│ ├── commit_validation.py
|
|
111
113
|
│ ├── clarification_workflow.py
|
|
112
114
|
│ └── approval_gate_workflow.py
|
|
113
|
-
├── config/ #
|
|
115
|
+
├── config/ # Configuración
|
|
114
116
|
│ └── git_standards.json
|
|
115
|
-
├── CLAUDE.md #
|
|
116
|
-
├── AGENTS.md #
|
|
117
|
-
├── CHANGELOG.md #
|
|
117
|
+
├── CLAUDE.md # Instrucciones del orquestador principal
|
|
118
|
+
├── AGENTS.md # Vista general del sistema
|
|
119
|
+
├── CHANGELOG.md # Historial de versiones
|
|
118
120
|
├── package.json
|
|
119
|
-
└── index.js #
|
|
121
|
+
└── index.js # Funciones auxiliares
|
|
120
122
|
```
|
|
121
123
|
|
|
122
|
-
##
|
|
124
|
+
## Estructura de Tu Proyecto
|
|
123
125
|
|
|
124
|
-
|
|
126
|
+
Después de la instalación:
|
|
125
127
|
|
|
126
128
|
```
|
|
127
|
-
|
|
128
|
-
├── .claude/ #
|
|
129
|
-
│ ├── agents/ → node_modules/@
|
|
130
|
-
│ ├── tools/ → node_modules/@
|
|
131
|
-
│ ├── hooks/ → node_modules/@
|
|
132
|
-
│ ├── commands/ → node_modules/@
|
|
133
|
-
│ ├──
|
|
134
|
-
│ ├── templates/ → node_modules/@
|
|
135
|
-
│ ├──
|
|
136
|
-
│ ├──
|
|
137
|
-
│ ├──
|
|
138
|
-
│
|
|
139
|
-
|
|
140
|
-
├──
|
|
141
|
-
├──
|
|
142
|
-
├──
|
|
143
|
-
├──
|
|
144
|
-
├── app-services/ # Your application code
|
|
129
|
+
tu-proyecto/
|
|
130
|
+
├── .claude/ # Symlinks a node_modules/@jaguilar87/gaia-ops/
|
|
131
|
+
│ ├── agents/ → node_modules/@jaguilar87/gaia-ops/agents/
|
|
132
|
+
│ ├── tools/ → node_modules/@jaguilar87/gaia-ops/tools/
|
|
133
|
+
│ ├── hooks/ → node_modules/@jaguilar87/gaia-ops/hooks/
|
|
134
|
+
│ ├── commands/ → node_modules/@jaguilar87/gaia-ops/commands/
|
|
135
|
+
│ ├── config/ → node_modules/@jaguilar87/gaia-ops/config/
|
|
136
|
+
│ ├── templates/ → node_modules/@jaguilar87/gaia-ops/templates/
|
|
137
|
+
│ ├── CHANGELOG.md → node_modules/@jaguilar87/gaia-ops/CHANGELOG.md
|
|
138
|
+
│ ├── logs/ # Específico del proyecto (NO symlink)
|
|
139
|
+
│ ├── tests/ # Específico del proyecto (NO symlink)
|
|
140
|
+
│ └── project-context.json # Específico del proyecto (NO symlink)
|
|
141
|
+
├── CLAUDE.md # Generado desde template
|
|
142
|
+
├── AGENTS.md → node_modules/@jaguilar87/gaia-ops/AGENTS.md
|
|
143
|
+
├── gitops/ # Tus manifiestos GitOps
|
|
144
|
+
├── terraform/ # Tu código Terraform
|
|
145
|
+
├── app-services/ # Tu código de aplicación
|
|
145
146
|
├── node_modules/
|
|
146
|
-
│ └── @
|
|
147
|
-
│ └──
|
|
147
|
+
│ └── @jaguilar87/
|
|
148
|
+
│ └── gaia-ops/ # Este paquete
|
|
148
149
|
└── package.json
|
|
149
150
|
```
|
|
150
151
|
|
|
151
152
|
## API
|
|
152
153
|
|
|
153
|
-
|
|
154
|
+
Si necesitas acceder a las rutas del paquete programáticamente:
|
|
154
155
|
|
|
155
156
|
```javascript
|
|
156
157
|
import {
|
|
157
158
|
getAgentPath,
|
|
158
159
|
getToolPath,
|
|
159
|
-
|
|
160
|
-
} from '@
|
|
160
|
+
getConfigPath
|
|
161
|
+
} from '@jaguilar87/gaia-ops';
|
|
161
162
|
|
|
162
163
|
const agentPath = getAgentPath('gitops-operator');
|
|
163
|
-
// → /path/to/node_modules/@
|
|
164
|
+
// → /path/to/node_modules/@jaguilar87/gaia-ops/agents/gitops-operator.md
|
|
164
165
|
|
|
165
166
|
const toolPath = getToolPath('context_provider.py');
|
|
166
|
-
// → /path/to/node_modules/@
|
|
167
|
+
// → /path/to/node_modules/@jaguilar87/gaia-ops/tools/context_provider.py
|
|
167
168
|
|
|
168
|
-
const
|
|
169
|
-
// → /path/to/node_modules/@
|
|
169
|
+
const configPath = getConfigPath('orchestration-workflow.md');
|
|
170
|
+
// → /path/to/node_modules/@jaguilar87/gaia-ops/config/orchestration-workflow.md
|
|
170
171
|
```
|
|
171
172
|
|
|
172
|
-
##
|
|
173
|
+
## Versionamiento
|
|
173
174
|
|
|
174
|
-
|
|
175
|
+
Este paquete sigue [Versionamiento Semántico](https://semver.org/):
|
|
175
176
|
|
|
176
|
-
- **MAJOR:**
|
|
177
|
-
- **MINOR:**
|
|
178
|
-
- **PATCH:**
|
|
177
|
+
- **MAJOR:** Cambios que rompen compatibilidad en el comportamiento del orquestador
|
|
178
|
+
- **MINOR:** Nuevas características, agentes o mejoras
|
|
179
|
+
- **PATCH:** Correcciones de bugs, clarificaciones, errores tipográficos
|
|
179
180
|
|
|
180
|
-
|
|
181
|
+
Versión actual: **1.0.3**
|
|
181
182
|
|
|
182
|
-
|
|
183
|
+
Ver [CHANGELOG.md](./CHANGELOG.md) para el historial de versiones.
|
|
183
184
|
|
|
184
|
-
##
|
|
185
|
+
## Documentación
|
|
185
186
|
|
|
186
|
-
- **
|
|
187
|
-
- **
|
|
188
|
-
- **
|
|
189
|
-
- **Git
|
|
190
|
-
- **
|
|
191
|
-
- **
|
|
187
|
+
- **Instrucciones Principales:** [CLAUDE.md](./CLAUDE.md) (154 líneas)
|
|
188
|
+
- **Vista General del Sistema:** [config/AGENTS.md](./config/AGENTS.md) (95 líneas)
|
|
189
|
+
- **Workflow de Orquestación:** [config/orchestration-workflow.md](./config/orchestration-workflow.md) (735 líneas)
|
|
190
|
+
- **Estándares Git:** [config/git-standards.md](./config/git-standards.md) (682 líneas)
|
|
191
|
+
- **Contratos de Contexto:** [config/context-contracts.md](./config/context-contracts.md) (673 líneas)
|
|
192
|
+
- **Catálogo de Agentes:** [config/agent-catalog.md](./config/agent-catalog.md) (603 líneas)
|
|
192
193
|
|
|
193
|
-
##
|
|
194
|
+
## Requisitos
|
|
194
195
|
|
|
195
196
|
- **Node.js:** >=18.0.0
|
|
196
197
|
- **Python:** >=3.9
|
|
197
|
-
- **Claude Code:**
|
|
198
|
+
- **Claude Code:** Última versión
|
|
198
199
|
- **Git:** >=2.30
|
|
199
200
|
|
|
200
|
-
##
|
|
201
|
+
## Gestión de Contexto de Proyecto
|
|
201
202
|
|
|
202
|
-
Gaia-Ops
|
|
203
|
+
Gaia-Ops usa un contexto de proyecto versionado como SSOT. Después de la instalación, clona tu contexto de proyecto:
|
|
203
204
|
|
|
204
205
|
```bash
|
|
205
206
|
cd .claude
|
|
206
|
-
git clone git@bitbucket.org:
|
|
207
|
+
git clone git@bitbucket.org:tuorg/tu-project-context.git project-context
|
|
207
208
|
```
|
|
208
209
|
|
|
209
|
-
|
|
210
|
+
Esto mantiene `project-context.json` versionado separadamente, mientras los datos de `session/` permanecen locales.
|
|
210
211
|
|
|
211
|
-
|
|
212
|
+
Ver [rnd-project-context](https://bitbucket.org/aaxisdigital/rnd-project-context) como ejemplo.
|
|
212
213
|
|
|
213
|
-
##
|
|
214
|
+
## Soporte
|
|
214
215
|
|
|
215
216
|
- **Issues:** [GitHub Issues](https://github.com/metraton/gaia-ops/issues)
|
|
216
|
-
- **
|
|
217
|
-
- **
|
|
217
|
+
- **Repositorio:** [github.com/metraton/gaia-ops](https://github.com/metraton/gaia-ops)
|
|
218
|
+
- **Autor:** Jorge Aguilar <jaguilar1897@gmail.com>
|
|
218
219
|
|
|
219
|
-
##
|
|
220
|
+
## Licencia
|
|
220
221
|
|
|
221
|
-
MIT License -
|
|
222
|
+
MIT License - Ver [LICENSE](./LICENSE) para detalles.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@jaguilar87/gaia-ops",
|
|
3
|
-
"version": "1.0
|
|
3
|
+
"version": "1.1.0",
|
|
4
4
|
"description": "Multi-agent orchestration system for Claude Code - DevOps automation toolkit",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"type": "module",
|
|
@@ -36,6 +36,7 @@
|
|
|
36
36
|
"speckit/",
|
|
37
37
|
"CLAUDE.md",
|
|
38
38
|
"CHANGELOG.md",
|
|
39
|
+
"README.en.md",
|
|
39
40
|
"index.js"
|
|
40
41
|
],
|
|
41
42
|
"scripts": {
|
package/speckit/README.md
CHANGED