ai-engineering-kit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ebert Mota
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,33 @@
+ai-engineering-kit
+Copyright (c) 2026 Ebert Mota
+
+This product includes skills derived from "Skills For Real Engineers"
+(mattpocock/skills): https://github.com/mattpocock/skills
+
+The skill buckets under the engineering/, productivity/, and misc/ categories
+are forked from, or inspired by, that project. Those skills are distributed
+under the following license and remain the copyright of their original author.
+
+-------------------------------------------------------------------------------
+MIT License
+
+Copyright (c) 2026 Matt Pocock
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+-------------------------------------------------------------------------------

package/README.md

@@ -0,0 +1,65 @@
+# ai-engineering-kit
+
+> An opinionated, agent-agnostic AI-development kit — disciplined skills plus a structured workspace — installed and updated through one `npx` command.
+
+## What it is
+
+`ai-engineering-kit` scaffolds a repeatable workflow for building software with AI coding agents:
+
+- **Skills** — Markdown playbooks for each step: kickoff → foundations → PRD → plan → TDD → review → verify.
+- **A structured workspace** — `ai/` for ephemeral artifacts (brainstorms, PRDs, plans, reviews) and `docs/foundations/` for canonical, long-lived project knowledge.
+- **Agent-agnostic wiring** — skills live as portable Markdown in `ai/skills/`; the kit generates the entry file each agent reads (`CLAUDE.md` + a `.claude/skills/` symlink for Claude Code, `AGENTS.md` for Codex). More agents are a template + a manifest entry away.
+
+## Quickstart
+
+```bash
+npx ai-engineering-kit
+```
+
+Run with no arguments for an interactive install: pick which **components** (skills / docs / workspace / entry-files), which **skill categories**, and which **agents** to wire up. The kit previews exactly what it will write, then scaffolds your selection and records it in a `.ai-kit.json` manifest.
+
+### Non-interactive
+
+```bash
+# scaffold a chosen set without prompts
+npx ai-engineering-kit init --name "My App" \
+  --components skills,docs-foundations,entry-files \
+  --categories core-workflow \
+  --agents claude-code,codex
+
+# or everything
+npx ai-engineering-kit init --all --name "My App"
+
+# preview a plan without writing anything
+npx ai-engineering-kit --dry-run --all
+```
+
+## Updating & adding parts
+
+Re-run the command in a project that already has the kit and it becomes **state-aware** (it reads `.ai-kit.json`):
+
+```bash
+npx ai-engineering-kit          # interactive: Add parts / Update to latest / both
+npx ai-engineering-kit update   # refresh installed parts to the latest version
+npx ai-engineering-kit add --components ai-workspace   # add a part later
+```
+
+Updates are **conflict-aware**: files you never touched refresh silently, and any file you edited is surfaced as a conflict with a per-file choice — **overwrite** with the new version, **keep mine**, or keep mine and save theirs as `<file>.new`. Files you added yourself are always preserved. The non-interactive `update` keeps your edits by default.
+
+## Reproducibility
+
+The template content is bundled inside the package and versioned with it, so a pinned version always produces the same scaffold:
+
+```bash
+npx ai-engineering-kit@1.4.0 init --all
+```
+
+## Credits & attribution
+
+`ai-engineering-kit` is **inspired by and forks skills from [Matt Pocock's `mattpocock/skills`](https://github.com/mattpocock/skills)** ("Skills For Real Engineers"), distributed under the MIT License. The `engineering/`, `productivity/`, and `misc/` skill categories are derived from that work. See [`NOTICE`](./NOTICE) for the retained copyright and license.
+
+Matt's newsletter: https://www.aihero.dev/s/skills-newsletter
+
+## License
+
+[MIT](./LICENSE) © Ebert Mota. Forked skills remain © their original authors — see [`NOTICE`](./NOTICE).