create-agent

Create new agents for the code-forge application. Agents are stored as .md files in the u003ccwdu003e/.forge/agents directory with YAML frontmatter (id, title, description, reasoning, tools, user_prompt) and markdown body containing agent instructions. Use when users need to add new agents, modify existing agents, or understand the agent file structure.

1. Upewnij się, że pracujesz w projekcie code-forge i masz dostęp do katalogu .forge/agents w głównym folderze projektu. Jeśli katalog nie istnieje, utwórz strukturę .forge/agents w katalogu roboczym projektu.

2. Przygotuj dane agenta: określ unikatowy identyfikator (id), tytuł wyświetlany, szczegółowy opis funkcjonalności, listę narzędzi dostępnych dla agenta (np. sem_search, read, write, shell) oraz szablon user_prompt dla kontekstu użytkownika.

3. Utwórz nowy plik Markdown o nazwie {agent-id}.md w katalogu .forge/agents, gdzie {agent-id} to identyfikator agenta. Plik musi zawierać frontmatter YAML na początku z polami: id, title, description, reasoning (z enabled: true/false), tools (lista) i user_prompt.

4. W treści pliku Markdown opisz tożsamość agenta, jego główny cel, zasady działania, dostępne możliwości, metodologię pracy oraz ograniczenia. Ta sekcja definiuje zachowanie i instrukcje dla agenta.

5. Zapisz plik w katalogu .forge/agents. Forge automatycznie odkryje i załaduje agenta z tego katalogu — to jedyna lokalizacja, gdzie system szuka plików agentów.

6. Aby zmodyfikować istniejącego agenta, otwórz odpowiadający mu plik .md, zmień potrzebne pola w frontmatter lub treści, i zapisz zmiany. Forge załaduje zaktualizowaną konfigurację.