@zweer/dev

Shared configurations, golden configs & Kiro AI templates for software projects.

What's Inside

| Directory | Purpose | |-----------|---------| | cli/ | CLI tool (dev bootstrap, dev setup, dev init-kiro) | | configs/ | Golden config files copied to target projects | | kiro/ | Kiro agent, prompt, steering & skill templates | | workflows/ | GitHub Actions workflow templates |

Quick Start

New project

npx @zweer/dev bootstrap my-project
cd my-project
npx @zweer/dev init-kiro

Existing project

npx @zweer/dev setup
npx @zweer/dev init-kiro

CLI Commands

dev bootstrap [name]

Scaffolds a new project with all golden configs, scripts, and dependencies.

dev setup

Adds golden configs to an existing project. Merges deps and scripts into package.json, copies config files (won't overwrite existing), installs base GitHub Actions workflows.

dev init-kiro

Installs the zweer-setup agent globally for Kiro-powered project configuration. After running, launch kiro-cli chat and use /agent swap zweer-setup to configure the project.

Golden Configs

All projects get these configs (via dev bootstrap or dev setup):

| Config | Tool | |--------|------| | biome.json | Biome (linter + formatter) | | tsconfig.json | TypeScript (@tsconfig/node22) | | tsdown.config.ts | tsdown (build) | | vitest.config.ts | Vitest (testing + v8 coverage) | | lefthook.yml | Lefthook (git hooks) | | commitlint.config.ts | Commitlint (conventional commits) | | .editorconfig | EditorConfig | | .lockfile-lintrc.json | Lockfile-lint (security) | | .npmpackagejsonlintrc.json | npm-package-json-lint |

Project Templates

dev bootstrap uses these templates:

| Template | Use case | Example repos | |----------|----------|---------------| | single (default) | Single npm package | utils (if single-pkg) | | monorepo | npm workspaces with packages/* | bonvoy, FlowRAG, utils |

For web apps (Next.js, SvelteKit, etc.), use the framework's own scaffolding tool first, then run dev setup to add golden configs.

Kiro Templates

The zweer-setup agent generates .kiro/ config for any project:

• 5 steering files: code-style, build-tooling, testing, interaction, commit-conventions
• Agent config: Tailored dev.json with project-specific write paths
• Prompt: Project-specific system prompt
• Skills: Monorepo scaffolding, etc.

Workflow Templates

| Tier | Workflows | When | |------|-----------|------| | Base | ci, pr, security, dependabot-auto-merge, dependabot-post-update | Always | | Library | npm release | npm packages | | Docs | VitePress deploy | Projects with docs/ |

Stack Decisions

• Biome today, Oxc when stable
• Lefthook (not husky + lint-staged)
• tsdown (not tsc for build)
• bonvoy (not semantic-release)
• @tsconfig/node22 (LTS)
• Copy config distribution (not extends)

Development

npm install
npm run build
npm test
npm run lint

License

MIT