feat(docs, api): Add Projects Discovery API, deploymentcenter project seed, public web docs endpoint, and minimal agent prompt template

2026-08-07 10:24:30 +02:00
parent c437bdee6f
commit a21536f495
11 changed files with 578 additions and 1 deletions
@@ -0,0 +1,42 @@
+# 📋 Minimal Agent Prompt Template (For CLAUDE.md / AGENTS.md / CursorRules)
+
+Copy & paste the following snippet into your agent system prompts or repository `CLAUDE.md` / `.cursorrules`:
+
+```markdown
+## 🐛 Central Bugtracker & Feature Logging Directive
+
+As an AI developer agent, you MUST track all unhandled errors, stack traces, planned features, and refactoring ideas in the central **Deployment Center Bugtracker**.
+
+### 1. Monitored Projects & Discovery
+Before reporting, check monitored projects via API or use the known project slug:
+- **Projects Discovery API**: `GET https://dc.mhdf.de/api/bugtracker/v1/projects.php`
+- **Known Slugs**: `deploymentcenter`, `myapp`, `polytrader`, `predictalytics`.
+*Note: If you discover a bug or issue in the Deployment Center code itself while working elsewhere, report it under `project_slug: "deploymentcenter"`.*
+
+### 2. Reporting Bugs & Ideas
+Submit reports via HTTP POST to: `https://dc.mhdf.de/api/bugtracker/v1/report.php`
+Header: `Authorization: Bearer <YOUR_AGENT_TOKEN>` (or `X-Agent-Token: <YOUR_AGENT_TOKEN>`)
+
+```json
+{
+  "project_slug": "deploymentcenter",
+  "type": "bug",
+  "title": "Short descriptive title of the error or feature",
+  "description": "Condition or context under which it occurred",
+  "error_message": "Exact exception message",
+  "stack_trace": "Complete stack trace snippet",
+  "severity": "high",
+  "push_id": "push_wf_8912",
+  "created_by": "agent:your-name"
+}
+```
+
+- **Severities**:
+  - `idea`: 💡 Quick reminder / thought for later
+  - `wishlist`: ⭐ Backlog feature request
+  - `low` / `medium` / `high` / `critical`: Standard bug severities
+
+### 3. Full API Documentation On-Demand
+If you need complete API details, token provisioning instructions, or cURL/Python examples, read:
+📄 **Documentation URL**: `https://dc.mhdf.de/docs/bugtracker.md`
+```