{"_id":"@amsmexico/baseline-cli","name":"@amsmexico/baseline-cli","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.4":{"name":"@amsmexico/baseline-cli","version":"0.1.4","description":"Team AI development toolkit — installs standards, skills and tooling for Claude Code, OpenCode, Kiro and Antigravity","repository":{"type":"git","url":"git+https://bitbucket.org/amsintegra/ams-base-ai.git"},"bin":{"baseline":"bin/baseline.js"},"main":"./dist/index.js","scripts":{"build":"tsup src/index.ts --format cjs --dts --outDir dist","dev":"tsx src/index.ts","lint":"tsc --noEmit","prepublishOnly":"npm run build"},"dependencies":{"chalk":"4.1.2","commander":"^12.1.0","fs-extra":"^11.2.0"},"devDependencies":{"@types/chalk":"^2.2.4","@types/fs-extra":"^11.0.4","@types/node":"^22.0.0","tsup":"^8.3.0","tsx":"^4.19.0","typescript":"^5.7.0"},"engines":{"node":">=18.0.0"},"publishConfig":{"registry":"https://registry.npmjs.org","access":"public"},"gitHead":"806e63b07c3d7b6f8b539e2a08a846769afb2952","types":"./dist/index.d.ts","_id":"@amsmexico/baseline-cli@0.1.4","bugs":{"url":"https://bitbucket.org/amsintegra/ams-base-ai/issues"},"homepage":"https://bitbucket.org/amsintegra/ams-base-ai#readme","_nodeVersion":"20.19.5","_npmVersion":"11.6.2","dist":{"integrity":"sha512-Zd4/RR84O2INWpbKSO0SJYbmXzyVsqIg2a82q/exzu83obHjOUtyTfzt5MZiek3xTaOXnlhgYG+LW4nnRQ5Acw==","shasum":"f424113e06d04ed5a627dab09be9264317001740","tarball":"https://registry.npmjs.org/@amsmexico/baseline-cli/-/baseline-cli-0.1.4.tgz","fileCount":59,"unpackedSize":351622,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDAQqEy5nzS9377wJVelpGm/c/njv58m0DDCK5SO/ooawIgblR5ejjvqtFVIMmz0in0VOE6IMmHZz+UJnPAQpiirpQ="}]},"_npmUser":{"name":"mikecobas","email":"cobas.miguel@gmail.com"},"directories":{},"maintainers":[{"name":"joseluis.ortiz","email":"joseluis.ortiz@humansite.com.mx"},{"name":"mikecobas","email":"cobas.miguel@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/baseline-cli_0.1.4_1784564286651_0.8033451379527534"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-20T16:18:06.459Z","0.1.4":"2026-07-20T16:18:06.836Z","modified":"2026-07-20T16:18:07.118Z"},"maintainers":[{"name":"joseluis.ortiz","email":"joseluis.ortiz@humansite.com.mx"},{"name":"mikecobas","email":"cobas.miguel@gmail.com"}],"description":"Team AI development toolkit — installs standards, skills and tooling for Claude Code, OpenCode, Kiro and Antigravity","homepage":"https://bitbucket.org/amsintegra/ams-base-ai#readme","repository":{"type":"git","url":"git+https://bitbucket.org/amsintegra/ams-base-ai.git"},"bugs":{"url":"https://bitbucket.org/amsintegra/ams-base-ai/issues"},"readme":"# baseline\n\n> One command to give your entire team the same AI tools, skills, and working rules — so anyone can pick up where someone else left off.\n\n[![npm](https://img.shields.io/npm/v/@baseline-ia/baseline-cli)](https://www.npmjs.com/package/@baseline-ia/baseline-cli)\n[![node](https://img.shields.io/node/v/@baseline-ia/baseline-cli)](https://nodejs.org)\n[![license](https://img.shields.io/npm/l/@baseline-ia/baseline-cli)](./LICENSE)\n\n---\n\n## Quick start\n\n```bash\nnpm install -g @baseline-ia/baseline-cli\nbaseline install\n```\n\nThat's it. Your machine now has the same setup as every other team member.\n\n---\n\n## What it installs\n\n| Component | Where |\n|-----------|-------|\n| AI skills (SDD, review, design, git…) | `~/.claude/skills/` · `~/.opencode/skills/` · `~/.kiro/skills/` |\n| Team standards block | `~/.claude/CLAUDE.md` · `~/.opencode/AGENTS.md` · `~/.kiro/steering/baseline.md` |\n| [Gentle-AI](https://github.com/Gentleman-Programming/gentle-ai) ecosystem | global |\n| [Engram](https://github.com/Gentleman-Programming/engram) MCP wiring (if installed) | per AI tool via `engram setup` |\n| Git hooks (pre-push blocks main, master, qa, develop) | `~/.baseline/hooks/` via `core.hooksPath` |\n| OpenSpec structure for spec-driven development | `./openspec/` in the project |\n\n---\n\n## Commands\n\n```bash\nbaseline install                  # auto-detect tools and configure all\nbaseline install claude           # configure only Claude Code\nbaseline install opencode         # configure only OpenCode\nbaseline install kiro-ide         # configure only Kiro IDE (~/.kiro detected)\nbaseline install kiro-cli         # configure only Kiro CLI (kiro binary detected)\nbaseline install codex            # configure only Codex\nbaseline update                   # pull latest baseline and re-apply standards\nbaseline status                   # show what's installed and configured\nbaseline doctor                   # diagnose missing or broken setup — includes Engram check\nbaseline onboard junior           # onboarding guide by level: junior · semi · senior\nbaseline mcp jira                 # configure Atlassian MCP (Jira) for all detected tools\n```\n\n---\n\n## Team workflow\n\nEvery change follows SDD (Spec-Driven Development):\n\n```\nexplore → propose → spec → design → tasks → apply → verify → archive\n```\n\nSkills are installed for every step. Start any change with:\n\n```bash\n/sdd-new <description of what you're building>\n```\n\n---\n\n## Supported AI tools\n\n| Tool | Skills | Team config | Gentle-AI preset |\n|------|--------|-------------|-----------------|\n| [Claude Code](https://claude.ai/code) | ✅ | ✅ `~/.claude/CLAUDE.md` | `full-gentleman` + SDD multi |\n| [OpenCode](https://opencode.ai) | ✅ | ✅ `~/.opencode/AGENTS.md` (strict TDD) | `full-gentleman` + SDD multi |\n| [Kiro IDE](https://kiro.dev) (`~/.kiro` detected) | ✅ | ✅ `~/.kiro/steering/baseline.md` + statusline sub-agent | `performance` + SDD multi |\n| [Kiro CLI](https://kiro.dev) (`kiro` binary detected) | ✅ | ✅ same as Kiro IDE | `performance` + SDD multi |\n| Codex | — | via gentle-ai | `recommended` |\n| Antigravity | — | coming soon | — |\n\nDetection is automatic — `baseline install` reads your environment and configures only the tools that are present. All tools use `--persona neutral`.\n\n---\n\n## Skills reference\n\n27 skills are installed across all supported tools. Each skill is invoked with `/skill-name` inside your AI tool.\nClick the skill name to see a concrete usage example. Each example shows real prompts and output — not limits on what the skill can do.\n\n### Architecture\n\n| Skill | What it does | Example prompt |\n|-------|-------------|----------------|\n| [`/architecture-guidelines`](example-sdd/06-architecture.md#architecture-guidelines--guiar-placement-de-archivos) | Validate and guide file placement across NestJS layers, Lambda, React Query/Zustand, and multi-tenancy rules. Enforces 7 CI/CD-blocking rules. | `/architecture-guidelines ¿dónde va la lógica de validación de un cupón?` |\n\n### SDD — Spec-Driven Development\n\n| Skill | What it does | Example prompt |\n|-------|-------------|----------------|\n| [`/sdd-new`](example-sdd/01-sdd-workflow.md#atajo-arrancar-directo) | Shortcut that runs explore + propose in one step. Entry point for any new change. | `/sdd-new quiero agregar autenticación JWT a la API` |\n| [`/sdd-explore`](example-sdd/01-sdd-workflow.md#fase-1--exploración) | Reads the codebase and maps the current state before proposing anything. | `/sdd-explore ¿cómo funciona actualmente el módulo de auth?` |\n| [`/sdd-propose`](example-sdd/01-sdd-workflow.md#fase-2--propuesta) | Writes the change proposal with intent, scope, risks, and approach. | `/sdd-propose` |\n| [`/sdd-spec`](example-sdd/01-sdd-workflow.md#fase-3--especificación) | Captures delta specs: requirements, scenarios, and contracts that change. | `/sdd-spec` |\n| [`/sdd-design`](example-sdd/01-sdd-workflow.md#fase-4--diseño-técnico) | Writes the technical design and records architecture decisions (ADRs). | `/sdd-design` |\n| [`/sdd-tasks`](example-sdd/01-sdd-workflow.md#fase-5--tasks) | Breaks the change into an ordered, checkable task list. | `/sdd-tasks` |\n| [`/sdd-apply`](example-sdd/01-sdd-workflow.md#fase-6--implementación) | Implements the tasks following spec and design, checks each one off as it goes. | `/sdd-apply` |\n| [`/sdd-verify`](example-sdd/01-sdd-workflow.md#fase-7--verificación) | Validates that the implementation matches spec, design, and tasks before archive. | `/sdd-verify` |\n| [`/sdd-archive`](example-sdd/01-sdd-workflow.md#fase-8--archive) | Closes the change: merges delta specs into main specs and moves to archive. | `/sdd-archive` |\n| `/sdd-init` | Bootstraps the `openspec/` structure in a project for the first time. | `/sdd-init` |\n| `/sdd-onboard` | Guided walkthrough of the full SDD cycle using the real codebase. | `/sdd-onboard` |\n\n### Code review\n\n| Skill | What it does | Example prompt |\n|-------|-------------|----------------|\n| [`/judgment-day`](example-sdd/02-review.md#judgment-day--revisión-adversarial-dual) | Two independent judges review the same code. Only issues both confirm get fixed. | `/judgment-day revisa el PR del módulo de pagos` |\n| [`/comment-writer`](example-sdd/02-review.md#comment-writer--comentarios-de-colaboración) | Writes warm, direct PR comments — collaborative tone, not accusatory. | `/comment-writer este método tiene un N+1 query, ¿cómo lo comento?` |\n\n### Git & pull requests\n\n| Skill | What it does | Example prompt |\n|-------|-------------|----------------|\n| [`/branch-pr`](example-sdd/08-git-jira-workflow.md#branch-pr--crear-el-pr-vinculado-al-trabajo) | Opens a PR linked to a Jira ticket or SDD change. Validates naming, commits, and tests before creating. | `/branch-pr` |\n| [`/chained-pr`](example-sdd/03-git-workflow.md#chained-pr--partir-un-pr-grande-en-cadena) | Splits oversized PRs (400+ lines) into a reviewable sequence. | `/chained-pr tengo 800 líneas de refactor en el módulo de usuarios` |\n| [`/work-unit-commits`](example-sdd/03-git-workflow.md#work-unit-commits--planear-commits-como-unidades-revieweables) | Plans commits as self-contained reviewable units before pushing. | `/work-unit-commits implementé notificaciones, auth y la integración` |\n\n### Documentation\n\n| Skill | What it does | Example prompt |\n|-------|-------------|----------------|\n| [`/changelog-generator`](example-sdd/05-docs-testing-github.md#changelog-generator--release-notes-desde-commits-de-git) | Transforms git commits into polished changelogs and release notes. | `/changelog-generator genera las release notes para v2.1.0` |\n| [`/cognitive-doc-design`](example-sdd/05-docs-testing-github.md#cognitive-doc-design--documentación-que-reduce-carga-cognitiva) | Designs guides, READMEs, and RFCs that minimize cognitive load. | `/cognitive-doc-design necesito un README para el microservicio de pagos` |\n\n### Design & frontend\n\n| Skill | What it does | Example prompt |\n|-------|-------------|----------------|\n| [`/frontend-design`](example-sdd/04-design.md#frontend-design--interfaces-web-con-alta-calidad-visual) | Builds production-grade web UIs — avoids generic AI aesthetics. | `/frontend-design página de login para un SaaS B2B, estilo profesional` |\n| [`/interface-design`](example-sdd/04-design.md#interface-design--dashboards-panels-y-herramientas-internas) | Builds dashboards, admin panels, and internal tools. | `/interface-design dashboard de métricas de pagos para operaciones` |\n| [`/tailwind-design-system`](example-sdd/04-design.md#tailwind-design-system--sistema-de-diseño-con-tailwind-css-v4) | Builds scalable design systems with Tailwind CSS v4: tokens, components, patterns. | `/tailwind-design-system sistema de diseño para suite de productos internos` |\n\n### Testing\n\n| Skill | What it does | Example prompt |\n|-------|-------------|----------------|\n| [`/go-testing`](example-sdd/05-docs-testing-github.md#go-testing--patrones-de-testing-para-go) | Applies focused Go testing patterns: coverage, TUI flows, teatest, golden files. | `/go-testing necesito testear un handler gRPC con dependencias externas` |\n\n### GitHub\n\n| Skill | What it does | Example prompt |\n|-------|-------------|----------------|\n| [`/issue-creation`](example-sdd/05-docs-testing-github.md#issue-creation--github-issues-con-contexto-completo) | Creates GitHub issues with full context: steps to reproduce, impact, expected behavior. | `/issue-creation el checkout falla en Safari cuando hay 2+ items` |\n\n### Jira\n\n| Skill | What it does | Example prompt |\n|-------|-------------|----------------|\n| [`/jira-workflow`](example-sdd/08-git-jira-workflow.md#jira-workflow--gestionar-tickets-desde-el-ai-tool) | Creates and updates Jira tickets linked to SDD changes. Post-commit hook adds comments automatically. Requires `baseline mcp jira`. | `/jira-workflow crea un ticket para agregar soporte de webhooks en pagos` |\n\n### Skills meta\n\n| Skill | What it does | Example prompt |\n|-------|-------------|----------------|\n| `/skill-creator` | Creates new LLM-first skills with valid SKILL.md frontmatter. | `/skill-creator quiero una skill para nuestro proceso de deploy` |\n| `/skill-improver` | Audits and refactors existing SKILL.md files: normalize conventions, improve quality. | `/skill-improver revisa la skill de branch-pr` |\n| `/skill-registry` | Rebuilds the skill index after adding or changing skills. | `/skill-registry` |\n\n---\n\n## Integrations\n\n### Jira (via Atlassian MCP)\n\nConnect your AI tools to Jira so the `/jira-workflow` skill can create and update tickets directly.\nSupported tools: **Claude Code**, **Kiro IDE**, **Kiro CLI**.\n\n**Quick setup:**\n\n```bash\nexport ATLASSIAN_SITE_URL=https://your-org.atlassian.net\nexport ATLASSIAN_USER_EMAIL=your@email.com\nexport ATLASSIAN_API_TOKEN=your-api-token\nbaseline mcp jira          # auto-detects your tools and configures all of them\n# restart your AI tool, then:\n/jira-workflow crea los tickets para la migración del módulo de pagos\n```\n\n**Full step-by-step guide (token generation, per-tool config, troubleshooting, Jira project setup):**\n→ [`docs/guides/jira-integration.md`](docs/guides/jira-integration.md)\n\n### Git workflow (branches, PRs, Jira linking)\n\nEvery branch must reference a Jira ticket (`feat/PROJ-123-description`) or an SDD change (`feat/sdd-<id>-description`). `baseline install` enforces this with two global git hooks:\n\n- **`pre-push`** — blocks direct pushes to `main`, `master`, `qa`, `develop` and rejects branches without a work item reference\n- **`post-commit`** — automatically posts a comment to the linked Jira ticket after every commit\n\n**Guides:**\n→ [`docs/guides/git-workflow.md`](docs/guides/git-workflow.md) — full step-by-step with both paths\n→ [`example-sdd/08-git-jira-workflow.md`](example-sdd/08-git-jira-workflow.md) — concrete examples (not limits)\n\n---\n\n## Requirements\n\n- Node.js >= 18\n- At least one supported AI tool installed\n\n---\n\n## CI — publish on release\n\nThe workflow in `.github/workflows/publish.yml` runs lint, build, and publish automatically when you create a GitHub release. Add your `NPM_TOKEN` as a repository secret to enable it.\n","readmeFilename":"README.md","_rev":"1-96b2099e71412764aae4263a5cffeabc"}