Imported from pinqponq/deveng-bot (
AGENTS.md). Install upstream withnpx skills add pinqponq/deveng-bot. Copyright stays with the author.
Agent guide — Deveng Bot
Short entry point for Claude Code, Cursor, and similar agents.
Before you change code
- Read
docs/ADDING-FEATURES.md(Türkçe:docs/ADDING-FEATURES.tr.md). - Prefer end-to-end features: panel + API + bot/worker + data. No sidebar-only placeholders.
- Never commit secrets (
.env, tokens, filledappsettings.Development.json). - Do not rename
Deveng.Discord.*folders/namespaces unless explicitly asked.
Repo map
| Area | Path |
|---|---|
| API | Deveng.Discord/Deveng.Discord.Api |
| Infrastructure / EF | Deveng.Discord/Deveng.Discord.Infrastructure |
| Web panel + BFF | Deveng.Discord.Web |
| Bot | Deveng.Discord.Bot |
| Compose | compose.yaml + root .env.example |
Builds (Windows PowerShell)
dotnet build Deveng.Discord/Deveng.Discord.Api/Deveng.Discord.Api.csproj -c Release
cd Deveng.Discord.Web; npm run build
cd ..\Deveng.Discord.Bot; npm run buildAfter code changes that affect these projects, run the relevant builds before finishing.
Auth / security defaults
- New API endpoints:
[DiscordAuth]or explicit[AllowAnonymous](deny-by-default). - Guild-scoped resources: verify
guildIdownership. - Bot↔API: keep HMAC headers (
BOT_SHARED_SECRET). - See
SECURITY.mdand the PR template security checklist.
More docs
- Setup:
README.md,docs/LOCAL-SETUP.md - Contributing:
CONTRIBUTING.md - Docs index:
docs/README.md
