{"id":47591632,"url":"https://github.com/eliecer2000/kiro-bootstrap","last_synced_at":"2026-04-01T17:33:09.417Z","repository":{"id":345279387,"uuid":"1184746879","full_name":"eliecer2000/kiro-bootstrap","owner":"eliecer2000","description":"Framework AWS-first para Kiro que detecta tu tipo de proyecto, valida e instala herramientas, carga agentes y skills por perfil, y deja el entorno listo para trabajar — en segundos.","archived":false,"fork":false,"pushed_at":"2026-03-18T13:23:02.000Z","size":741,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-19T02:10:08.313Z","etag":null,"topics":["ai-agents","aws","bootstrap","cdk","developer-tools","devtools","kiro","kiro-ai","kiro-cli","kiro-dev","kiro-ide","kiro-steering","terraform"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eliecer2000.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-17T22:30:49.000Z","updated_at":"2026-03-18T22:23:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/eliecer2000/kiro-bootstrap","commit_stats":null,"previous_names":["eliecer2000/kiro-bootstrap"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/eliecer2000/kiro-bootstrap","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eliecer2000%2Fkiro-bootstrap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eliecer2000%2Fkiro-bootstrap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eliecer2000%2Fkiro-bootstrap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eliecer2000%2Fkiro-bootstrap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eliecer2000","download_url":"https://codeload.github.com/eliecer2000/kiro-bootstrap/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eliecer2000%2Fkiro-bootstrap/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290537,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","aws","bootstrap","cdk","developer-tools","devtools","kiro","kiro-ai","kiro-cli","kiro-dev","kiro-ide","kiro-steering","terraform"],"created_at":"2026-04-01T17:33:08.460Z","updated_at":"2026-04-01T17:33:09.409Z","avatar_url":"https://github.com/eliecer2000.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Orbit Bootstrap\n\n\u003e AWS-first framework for [Kiro](https://kiro.dev) that auto-detects your project type, validates and installs tooling, loads the right agents and skills per profile, and leaves your environment ready to build in seconds.\n\n[![GitHub stars](https://img.shields.io/github/stars/eliecer2000/kiro-bootstrap?style=social)](https://github.com/eliecer2000/kiro-bootstrap/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/eliecer2000/kiro-bootstrap?style=social)](https://github.com/eliecer2000/kiro-bootstrap/network)\n[![Last commit](https://img.shields.io/github/last-commit/eliecer2000/kiro-bootstrap)](https://github.com/eliecer2000/kiro-bootstrap/commits/main)\n[![Version](https://img.shields.io/badge/version-2.5.0-blue)](https://github.com/eliecer2000/kiro-bootstrap/releases)\n\n🇪🇸 [Documentación en Español](README_es.md)\n\n---\n\n![Orbit Bootstrap Demo](assets/REC-20260318140741.gif)\n\n---\n\n## The problem it solves\n\nEvery AWS project starts the same way: copy-paste configs, install linters, hunt for the right agent prompts, wire up hooks, remember which steering rules apply. It is repetitive, error-prone, and burns time before you write a single line of business logic.\n\nOrbit eliminates that friction. It reads your project, resolves the right profile, validates your environment, and loads a curated set of agents, skills, steering rules, and hooks — all tailored to your stack. You go from a blank directory to a fully configured AI-assisted workspace in one command.\n\n---\n\n## How it works\n\nOrbit runs a 6-step pipeline when you prepare a project:\n\n```\n1. Session Gates          Ask once per session if you want to prepare the environment\n2. Detect / Select Profile  Auto-detect project type or launch an interactive wizard\n3. Validate Environment   Check system tools (git, node, python3, aws, terraform)\n                          and auto-install missing ones via brew / apt / nvm / corepack\n4. Load Artifacts         Copy agents, steering packs, skills, hooks, and extensions\n                          from the framework into .kiro/ scoped to your profile\n5. Install Tooling        Install project devDependencies (eslint, prettier, vitest,\n                          ruff, black, pytest, tsc, mypy) using the detected package manager\n6. Write Project State    Write .kiro/.orbit-project.json with profile metadata\n```\n\nProfile resolution uses 4 dimensions:\n\n| Dimension   | Options |\n|-------------|---------|\n| Workload    | backend-api, backend-worker, infra, shared-lib, frontend-amplify |\n| Runtime     | typescript, javascript, python |\n| Provisioner | cdk, terraform |\n| Framework   | react, vue, nuxt (frontend-amplify only) |\n\nAuto-detection evaluates required files, globs, package.json dependencies (wildcard support like @aws-sdk/*), and text patterns. If no profile matches, the wizard kicks in.\n\n---\n\n## Installation\n\n```bash\ncurl -sL https://raw.githubusercontent.com/eliecer2000/kiro-bootstrap/main/install.sh | bash\n```\n\nAfter installing:\n\n```bash\n~/.kiro/orbit/install.sh --help\n~/.kiro/orbit/install.sh --update\n~/.kiro/orbit/install.sh --resync-project .\n~/.kiro/orbit/install.sh --status\n~/.kiro/orbit/install.sh --doctor\n```\n\n---\n\n## Profiles\n\n### Phase 1 - Active\n\n| Profile | Workload | Runtime | Provisioner |\n|---|---|---|---|\n| aws-backend-api-typescript | API Backend | TypeScript | - |\n| aws-backend-api-python | API Backend | Python | - |\n| aws-backend-api-javascript | API Backend | JavaScript | - |\n| aws-backend-lambda-typescript | Lambda Worker | TypeScript | - |\n| aws-backend-lambda-python | Lambda Worker | Python | - |\n| aws-backend-lambda-javascript | Lambda Worker | JavaScript | - |\n| aws-infra-cdk-typescript | Infrastructure | TypeScript | CDK |\n| aws-infra-terraform | Infrastructure | HCL | Terraform |\n| aws-shared-lib-typescript | Shared Library | TypeScript | - |\n| aws-shared-lib-python | Shared Library | Python | - |\n| aws-shared-lib-javascript | Shared Library | JavaScript | - |\n\n### Phase 2 - Ready (disabled)\n\n| Profile | Framework |\n|---|---|\n| aws-amplify-react | React |\n| aws-amplify-vue | Vue |\n| aws-amplify-nuxt | Nuxt |\n\n---\n\n## Agents\n\n14 specialized agents assigned per profile. Each agent has a declared role, responsibilities, and handoff rules so they coordinate automatically without manual wiring.\n\n| Agent | Role |\n|---|---|\n| orbit | Bootstrap, onboarding, re-sync, and coordination |\n| aws-architect | AWS architecture, serverless patterns, design decisions |\n| aws-lambda-python | Lambda functions with Python |\n| aws-lambda-typescript | Lambda functions with TypeScript / JavaScript |\n| aws-api-integration | API contracts, events, auth, integrations |\n| aws-cdk | Infrastructure with AWS CDK |\n| aws-terraform | Infrastructure with Terraform |\n| aws-iam-security | IAM, secrets, encryption, least privilege |\n| aws-data-dynamodb | DynamoDB modeling and access patterns |\n| aws-observability | Logs, metrics, alarms, traces |\n| aws-test-quality | Tests, quality gates, technical acceptance |\n| aws-amplify-react | Frontend Amplify + React (phase 2) |\n| aws-amplify-vue | Frontend Amplify + Vue (phase 2) |\n| aws-amplify-nuxt | Frontend Amplify + Nuxt (phase 2) |\n\nHandoffs are declared in agents-registry.json: orbit to aws-architect when architecture is needed, aws-architect to aws-iam-security when decisions touch IAM or networking, aws-lambda agents to aws-test-quality when tests are required.\n\n---\n\n## Skills\n\n22 local skills organized by domain. Skills are Markdown documents loaded into agent context — they carry domain rules, code examples, anti-patterns, and validation checklists.\n\n| Category | Skills |\n|---|---|\n| Runtime | typescript-runtime, javascript-runtime, python-runtime |\n| Serverless | aws-lambda-typescript, aws-lambda-python, aws-serverless |\n| API and Data | aws-api, aws-dynamodb |\n| Infrastructure | aws-cdk, aws-terraform, aws-ec2, aws-rds, aws-s3, aws-cloudfront |\n| Security | aws-security |\n| Operations | aws-observability, aws-cost-operations, aws-diagrams |\n| Testing | aws-testing |\n| Architecture | aws-architecture |\n| Framework | orbit-bootstrap, find-skills |\n\nfind-skills is mandatory in every profile — lets agents discover and activate additional skills on demand.\n\n---\n\n## Steering packs\n\nSteering packs are context rules injected into every Kiro session. They encode team standards, AWS best practices, and runtime-specific conventions so agents follow them without being told.\n\nShared packs in every profile: core, git, security, aws-shared, testing, observability.\n\nAdditional packs per profile: runtime-typescript, runtime-python, runtime-javascript, lambda, api, cdk, terraform, amplify.\n\nThree inclusion modes: `always` (every session), `fileMatch` (when a matching file is opened), `manual` (user-triggered via # in chat).\n\n---\n\n## Hooks\n\nAutomated hooks run on IDE events with no manual setup. Each profile gets the hooks that match its runtime:\n\n| Runtime | Hooks |\n|---|---|\n| Node.js (TS/JS) | format on save, lint on save, test after task |\n| Python | format on save, lint on save, test after task |\n| Terraform | fmt on save, validate after task |\n\n---\n\n## Declarative catalog\n\nEverything in Orbit is declarative. The catalog is the source of truth:\n\n- `manifest.json` — pipeline steps, policies (conflict strategy, remote skills, session opt-out), wizard questions, public commands\n- `profiles/*.json` — one file per profile: dimensions, detection rules, tooling, agents, steering, skills, hooks, validations\n- `agents-registry.json` — full contract per agent: role, responsibilities, handoffs, skills, model, acceptance checklist, remote skills allowlist\n\nThe runtime (`lib/orbit_catalog.py`) reads the catalog and acts. No hardcoded logic.\n\n---\n\n## Catalog validation\n\n```bash\npython3 lib/orbit_catalog.py --bootstrap-dir . validate-catalog\n```\n\nCross-validates manifest, profiles, and agents-registry: required fields, agent references, remote skills allowlist, and presence of agent files.\n\n---\n\n## Running from Kiro chat\n\nWhen Orbit operates from the Kiro chat, it runs the real pipeline before any scaffolding:\n\n```bash\nORBIT_BOOTSTRAP_DECISION=yes \\\nORBIT_HOME_DECISION=no \\\nORBIT_PROJECT_PROFILE_ID=\u003cprofile-id\u003e \\\nORBIT_REMOTE_SKILL_DECISION=no \\\n~/.kiro/orbit/install.sh --resync-project \"\u003cpath\u003e\"\n```\n\nOrbit resolves the profile-id internally from the wizard. It never asks for the raw ID, AWS credentials, or CLI profile during normal bootstrap. Scaffolding only starts after `.kiro/.orbit-project.json` exists and all artifact directories are loaded.\n\n---\n\n## Repository structure\n\n```\nagents/          Agent JSON definitions\nprofiles/        Project profiles (detection, tooling, validations, agents, skills)\nsteering/        Steering packs by technical layer\nskills/          Local skills with full documentation\nhooks/           Automated hooks by runtime (format, lint, test)\nextensions/      Kiro extension packs per profile\nlib/             Runtime: pipeline, session, catalog, artifact loading, tooling install\nvalidations/     System tool validation and auto-install\ndocs/            Technical documentation\ntemplates/       Context templates for project onboarding\ntests/           Framework test suite\n```\n\n---\n\n## Tests\n\n```bash\nbash tests/test-all.sh\n```\n\n---\n\n## Documentation\n\n- [Architecture](docs/architecture.md) — Components, declarative catalog, runtime\n- [Bootstrap Flow](docs/bootstrap-flow.md) — Step-by-step pipeline\n- [Profile Matrix](docs/profile-matrix.md) — Detail per profile\n- [Agent Catalog](docs/agent-catalog.md) — Roles, responsibilities, handoffs\n- [Authoring Guide](docs/authoring.md) — How to add agents, skills, profiles, steering\n\n---\n\n## Releases\n\n```bash\nbash release.sh 2.5.0\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md#release-process) for details.\n\n---\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for how to add profiles, agents, skills, and steering packs.\n\nPlease read our [Code of Conduct](CODE_OF_CONDUCT.md) before participating.\n\n## Security\n\nTo report a vulnerability, see [SECURITY.md](SECURITY.md). Do not open public issues for security concerns.\n\n## License\n\n[MIT](LICENSE) — Eliezer Rangel\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feliecer2000%2Fkiro-bootstrap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feliecer2000%2Fkiro-bootstrap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feliecer2000%2Fkiro-bootstrap/lists"}