docs(contributing): add repository guidelines and update contribution instructions

Author: Romakita

AGENTS.md

@@ -0,0 +1,25 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+Yarn 4 + Lerna workspaces organize sources under `packages/*`: `cli` hosts command entrypoints and generator templates, `cli-core` handles DI/prompt infrastructure, `cli-mcp` exposes MCP servers and tools, while `cli-plugin-*` packages bundle framework-specific blueprints plus their own tests. `cli-testing` provides shared harnesses, templates live in `packages/cli/templates`, artifacts land in `dist/`, VuePress + TSDoc files stay in `docs/`, and `tools/*` holds automation scripts (TypeScript references, ESLint, Vitest installers).
+
+## Build, Test, and Development Commands
+
+- `yarn build`: runs `monorepo build --verbose` across every workspace.
+- `yarn build:references`: refreshes TS project references after renaming or adding packages.
+- `yarn test`: executes the Vitest suite once; add `--coverage` for V8 reports.
+- `yarn lint` / `yarn lint:fix`: applies the flat ESLint config + Prettier formatting used in CI.
+- `yarn docs:serve` / `yarn docs:build`: runs `lerna run build && tsdoc` then serves or builds the VuePress site.
+
+## Coding Style & Naming Conventions
+
+Author TypeScript ES modules with 2-space indentation, double quotes, and trailing commas per the shared Prettier rules. Favor named exports and keep command providers in `packages/cli/src/commands/**/NameCmd.ts`, suffixing classes with `Cmd`. Tests and utilities mirror their source paths, ending in `.spec.ts` or `.integration.spec.ts`. Plugin packages follow `cli-plugin-<feature>` naming; templates underneath use kebab-case folder names. Keep import blocks sorted (enforced by `eslint-plugin-simple-import-sort`) and reserve default exports for entry aggregators such as `packages/cli/src/index.ts`.
+
+## Testing Guidelines
+
+Vitest powers both unit and integration coverage. Co-locate fast tests next to implementation files, while scenario-heavy suites live under `packages/*/test/**`. Use `yarn vitest packages/cli/src/commands/init/InitCmd.spec.ts` to focus a file, prefer `.integration.spec.ts` when exercising generators end-to-end, and ship PRs with `yarn test --coverage` so CI can enforce thresholds. Mock filesystem access via helpers in `cli-testing` instead of touching the real disk.
+
+## Commit & Pull Request Guidelines
+
+Commit messages must satisfy Conventional Commits (see `commitlint.config.js`); scope by workspace, e.g., `feat(cli-plugin-prisma): expand seed template`. Keep subjects under 200 characters and describe behavior, not implementation minutiae. Before opening a pull request, run `yarn build`, `yarn test`, and `yarn lint`, update docs/templates when behavior changes, and link the relevant issue. Summaries should highlight user-facing changes, test evidence, and screenshots or logs when generator output shifts.

CONTRIBUTING.md

@@ -1,10 +1,13 @@
-# Contributing 
+# Contributing
+
 ## Introduction
 
 First, thank you for considering contributing to Ts.ED! It is people like you that make the open source community such a great community! 😊
 
 We welcome any type of contribution, not just code. You can help with:
 
+- Repository-specific build, testing, and PR expectations are summarized in the [Repository Guidelines](AGENTS.md); please skim them before opening a pull request.
+
 - QA: file bug reports, the more details you can give the better (e.g. screenshots with the console open)
 - Marketing: writing blog posts, how to's, printing stickers, ...
 - Community: presenting the project at meetups, organizing a dedicated meetup for the local community, ...
@@ -23,15 +26,15 @@ Code review process
 The bigger the pull request, the longer it will take to review and merge. Try to break down large pull requests in smaller chunks that are easier to review and merge. It is also always helpful to have some context for your pull request. What was the purpose? Why does it matter to you?
 
 ---
+
 ### WARNING
 
 Ts.ED project uses [conventional commits](https://www.conventionalcommits.org/en/v1.0.0-beta.4/) as format commit message.
 
 Release note and tagging version are based on the message commits.
 If you don't follow the format, our CI won't be able to increment the version correctly and your feature won't be released on NPM.
 
-To write your commit message, see [convention page here](https://www.conventionalcommits.org/en/v1.0.0-beta.4/)
----
+## To write your commit message, see [convention page here](https://www.conventionalcommits.org/en/v1.0.0-beta.4/)
 
 ## Financial contributions
 
@@ -42,6 +45,7 @@ We also welcome financial contributions in full transparency on our open collect
 If you have any questions, create an [issue](https://github.com/tsedio/tsed/issues) (protip: do a quick search first to see if someone else didn't ask the same question before!). You can also reach us at https://gitter.im/Tsed-io/community.
 
 ## How to work on Ts.ED
+
 ### Setup
 
 Clone your fork of the repository
@@ -51,6 +55,7 @@ $ git clone https://github.com/YOUR_USERNAME/tsed-cli.git
 ```
 
 Install npm dependencies with yarn (not with NPM!):
+
 ```bash
 yarn
 ```
@@ -59,7 +64,7 @@ Compile TypeScript:
 
 ```bash
 yarn build
-// or 
+// or
 npm run build
 ```
 
@@ -101,6 +106,7 @@ git commit -m "feat(domain): Your message"
 ```
 
 Then:
+
 ```bash
 npm run test
 git fetch
@@ -142,18 +148,17 @@ yarn vuepress:serve
 - Feel free to ask for help from other members of the Ts.ED team.
 
 ## Credits
+
 ### Contributors
 
 <a href="https://github.com/tsedio/ts-express-decorators/graphs/contributors"><img src="https://opencollective.com/tsed/contributors.svg?width=890" /></a>
 
-
 ### Backers
 
 Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/tsed#backer)]
 
 <a href="https://opencollective.com/tsed#backers" target="_blank"><img src="https://opencollective.com/tsed/backers.svg?width=890"></a>
 
-
 ### Sponsors
 
 Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/tsed#sponsor)]