Skip to content
Back to search

ai-coding-project-boilerplate

Agentic coding TypeScript boilerplate for Claude Code: sub-agent workflows with built-in quality checks and context engineering.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/shinpr/ai-coding-project-boilerplate with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/shinpr/ai-coding-project-boilerplate'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/shinpr--ai-coding-project-boilerplate/badge.svg)](/listings/shinpr--ai-coding-project-boilerplate)

HTML

<a href="/listings/shinpr--ai-coding-project-boilerplate"><img src="/api/listings/shinpr--ai-coding-project-boilerplate/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requires Node.js 24.15+, pnpm, and Claude Code.

Start a new project

npx create-ai-project my-project
cd my-project
pnpm install
claude

Add `--lang=ja` or `--lang=zh-CN` to the first command to use Japanese or Simplified Chinese workflow instructions.

Run your first change

Once Claude Code is running:

/project-inject
/implement Add rate limiting to the API

`/project-inject` sets up the initial project context.

`/implement` clarifies the request and inspects the existing code. Straightforward changes can proceed without design documents. When design decisions are needed, it prepares a design and plan for your approval before implementation. It then runs the applicable checks and reviews larger changes.

See the [Quick Start Guide](docs/guides/en/quickstart.md) for the full setup and first-run walkthrough.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 124 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # AI Coding Project Boilerplate: A Starter Kit for Claude Code
  2. *Read this in other languages: [日本語](README.ja.md) | [简体中文](README.zh-CN.md)*
  3. [![TypeScript](https://img.shields.io/badge/TypeScript-7.x-blue?logo=typescript)](https://www.typescriptlang.org/)
  4. [![Node.js](https://img.shields.io/badge/Node.js-26.12.1%2B-green?logo=node.js)](https://nodejs.org/)
  5. [![Claude Code](https://img.shields.io/badge/Claude%20Code-Optimized-purple)](https://claude.ai/code)
  6. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  7. Set up a TypeScript repository for development with Claude Code. `create-ai-project` adds a project-level `CLAUDE.md`, ready-to-use commands, specialized agents, and skills so Claude can follow your repository's rules while working on changes.
  8. Use this starter kit to create a new project and keep its Claude Code setup up to date. You get a working development environment without assembling prompts and agent definitions yourself. Your team can version, share, and adapt that environment alongside the code.
  9. ## What you can start with
  10. - Develop with TypeScript, Biome formatting and linting, and Vitest already configured
  11. - Record project context and quality standards for later sessions and other contributors
  12. - Turn team knowledge into skills Claude can use when the work calls for them
  13. ## Quick start
  14. Requires Node.js 26.12.1+, pnpm, and Claude Code.
  15. ### Start a new project
  16. ```bash
  17. npx create-ai-project my-project
  18. cd my-project
  19. pnpm install
  20. claude
  21. ```
  22. Add `--lang=ja` or `--lang=zh-CN` to the first command to use Japanese or Simplified Chinese workflow instructions.
  23. ### Run your first change
  24. Once Claude Code is running:
  25. ```text
  26. /project-inject
  27. /implement Add rate limiting to the API
  28. ```
  29. `/project-inject` sets up the initial project context.
  30. `/implement` clarifies the request and inspects the existing code. Straightforward changes can proceed without design documents. When design decisions are needed, it prepares a design and plan for your approval before implementation. It then runs the applicable checks and reviews larger changes.
  31. See the [Quick Start Guide](docs/guides/en/quickstart.md) for the full setup and first-run walkthrough.
  32. ## Choose a workflow
  33. | What you want to do | Start with |
  34. |---|---|
  35. | Take a feature from a request through implementation and verification | `/implement` |
  36. | Make a focused change with a clear scope | `/task` |
  37. | Design a change before coding | `/design`, `/front-design` |
  38. | Turn an approved design into an executable plan | `/plan`, `/front-plan` |
  39. | Implement an approved plan | `/build`, `/front-build` |
  40. | Review completed implementation against the agreed outcome and repository standards | `/review`, `/front-review` |
  41. | Investigate a problem before choosing a fix, without changing code | `/diagnose` |
  42. ### Design now, implement later
  43. ```text
  44. /design Add rate limiting to the API
  45. /plan
  46. /build
  47. ```
  48. The design command stops for approval. You can continue planning and implementation later, in a new session or with another contributor, using the approved documents. The plan records what each task must deliver and how to check it, so the handoff does not depend on reconstructing the earlier conversation.
  49. For frontend work, use the corresponding commands:
  50. ```text
  51. /front-design Add a user profile dashboard
  52. /front-plan
  53. /front-build
  54. ```
  55. See [Use Cases & Commands](docs/guides/en/use-cases.md) for examples and the complete command reference.
  56. ## Workflow modes
  57. Normal Mode is the default. Choose Lite Mode when you want fewer independent checks and agent calls. It skips checks of design documents against the code and against each other, along with the separate security review. For planned work, Normal Mode runs repository checks such as lint and tests after each task. Lite Mode runs them together after implementation, before code review.
  58. Claude still checks its changes, reviews required tests, and asks for your approval at the same points. Code review remains in place. Small changes and fixes made after review still get the usual quality checks.
  59. To save Lite Mode as the project's default, run this from the project root:
  60. ```bash
  61. node scripts/set-workflow-mode.js lite
  62. ```
  63. The setting is saved in `CLAUDE.md`, so future sessions use it without a mode request. Run `node scripts/set-workflow-mode.js normal` to restore Normal Mode. A mode you explicitly request in conversation overrides the project default for the rest of that session, unless you change it again.
  64. ## Adapt the environment to your project
  65. Use `/project-inject` to record the project's purpose, constraints, quality standards, conventions, and external sources. Run it again when those facts change.
  66. For guidance that applies only to particular tasks, use `/create-skill` or `/refine-skill`. These commands help you decide where the guidance belongs and review it before use. See the [Skills Editing Guide](docs/guides/en/skills-editing-guide.md) for examples.
  67. ## Keep the Claude Code setup up to date
  68. From the root of a project created with this starter kit, preview the update, then apply it:
  69. ```bash
  70. npx create-ai-project update --dry-run
  71. npx create-ai-project update
  72. claude
  73. ```
  74. The updater replaces the managed Claude Code rules, commands, agents, and skills. Local edits to files being updated are overwritten. It preserves your source code, existing package settings, and saved workflow mode.
  75. Before updating, commit your project-specific rules and skills, including changes made with `/project-inject`, `/create-skill`, or `/refine-skill`. After the update, review what changed and manually reapply the customizations you want to keep. See the [Quick Start Guide](docs/guides/en/quickstart.md) for update details.
  76. ## Guides
  77. - [Quick Start Guide](docs/guides/en/quickstart.md)
  78. - [Use Cases & Commands](docs/guides/en/use-cases.md)
  79. - [Skills Editing Guide](docs/guides/en/skills-editing-guide.md)
  80. ## License
  81. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.