docs: Add Sprint 9 lessons learned
Captured two lessons from Sprint 9: 1. Gitea Labels API requires org context - workaround for user repos 2. Always read CLAUDE.md before asking questions about sprint context Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,29 @@
|
||||
# Sprint 9 - Gitea Labels API Requires Org Context
|
||||
|
||||
## Context
|
||||
Creating Gitea issues with labels via MCP tools during Sprint 9 planning for the personal-portfolio project.
|
||||
|
||||
## Problem
|
||||
When calling `create_issue` with a `labels` parameter, received:
|
||||
```
|
||||
404 Client Error: Not Found for url: https://gitea.hotserv.cloud/api/v1/orgs/lmiranda/labels
|
||||
```
|
||||
|
||||
The API attempted to fetch labels from an **organization** endpoint, but `lmiranda` is a **user account**, not an organization.
|
||||
|
||||
## Solution
|
||||
Created issues without the `labels` parameter and documented intended labels in the issue body instead:
|
||||
```markdown
|
||||
**Labels:** Type/Feature, Priority/Medium, Complexity/Simple, Efforts/XS, Component/Docs, Tech/Python
|
||||
```
|
||||
|
||||
This provides visibility into intended categorization while avoiding the API error.
|
||||
|
||||
## Prevention
|
||||
- When working with user-owned repos (not org repos), avoid using the `labels` parameter in `create_issue`
|
||||
- Document labels in issue body as a workaround
|
||||
- Consider creating a repo-level label set for user repos (Gitea supports this)
|
||||
- Update projman plugin to handle user vs org repos differently
|
||||
|
||||
## Tags
|
||||
gitea, mcp, api, labels, projman, configuration
|
||||
Reference in New Issue
Block a user