chore: document similar-project scan in AGENTS.md; ignore .serena/ (#8)

* chore: document similar-project scan in AGENTS.md; ignore .serena/ and .DS_Store

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* chore: add .shipguard.yml — exclude node_modules, acknowledge upstream JS debt

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: actually ignore .serena/ (prior commit added negation only)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: newblacc <refactor code>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Maxime Roy (new.blacc)
2026-04-06 09:57:07 +02:00
committed by GitHub
co-authored by Claude Sonnet 4.6 newblacc <refactor code>
parent 81f38de508
commit f770c811e9
3 changed files with 47 additions and 1 deletions
+21
View File
@@ -92,6 +92,27 @@ All middleware lives here — do not duplicate in routes:
- Tests mutate `process.env` between cases — do not cache env values at module init.
- Integration tests use real SQLite (tmpdir). Do not mock the DB.
## Similar Project Scan
- Use `npm run scan:similar-projects` to scan GitHub for architecturally similar Excalidraw projects.
- The scanner is capability-based, not fork-based: it looks for Excalidraw plus MCP, backend sync, persistence, security, workspace isolation, and self-hosting signals.
- When looking for broader competitors instead of this repo's own lineage, run:
```bash
npm run scan:similar-projects -- \
--exclude-repo yctimlin/mcp_excalidraw \
--exclude-repo sanjibdevnathlabs/mcp-excalidraw-local \
--exclude-repo celstnblacc/excalidraw-mcp-sentinel
```
- Reports are written to `docs/generated/` as JSON and Markdown.
- For repeated or larger scans, prefer setting `GITHUB_TOKEN` to avoid GitHub anonymous API rate limits.
- Rerun the scan after significant product or architecture changes. Changes to MCP features, persistence, security, or backend topology can materially change which repos are the closest matches.
- Reference docs:
- `docs/GUIDE-excalidraw-similar-project-search.md`
- `docs/AUDIT-excalidraw-similar-project-scan.md`
- `docs/COMPARISON-excalidraw-top-repos.md`
## Protected Files
- `AGENTS.md` — immutable unless explicitly named in the request.