@teakit/cli LLM Contract
@teakit/cli is the command-line tool for creating, checking, and maintaining Teakit tslib projects.
Current Status
The package has been renamed from the old boilerplate template to @teakit/cli.
The final CLI command implementation is still pending. Do not generate code that assumes the planned commands are already implemented unless the relevant source and tests exist.
Planned Command Surface
Bun Runtime Contract
- Use Bun as the development environment, test runner, script runner, and CLI runtime target.
- Implement CLI behavior with Bun-provided APIs and built-in platform capabilities.
- Keep runtime
dependenciesempty. - Generated
tslibprojects should default to Bun.
Generation Rules
- Treat
@teakit/clias a CLI package, not a reusable library template. - Do not refer to this package as
@teakit/boilerplate. - Do not use
project-templateas the package skill name. - Do not treat the old boilerplate example as public product API.
- Clearly distinguish planned commands from implemented commands.
- Do not reintroduce the previous command surface unless a future proposal explicitly changes it.
- Do not add a fix mode to
teakit doctor; it should output results for an AI agent to apply. - When CLI behavior, commands, flags, package exports, or agent-facing usage changes, update
README.md,skills/index.mdx,skills/teakit-cli/SKILL.md, and this file.
Project Workflow
- Read
AGENTS.mdbefore modifying the repository. - Read
docs/knowledge/index.mdanddocs/memory/index.mdwhen context is needed. - Read
docs/proposals/v1-implementation.mdfor the current V1 command direction while implementation is pending. - Read
skills/teakit-cli/SKILL.mdbefore changing command-facing behavior or command documentation. - If API, behavior, commands, or agent-facing usage changes, update nearby tests and docs.