Add agent knowledge files for all modules

This commit is contained in:
Wuesteon 2025-12-17 15:56:59 +01:00
parent 11324b5e68
commit dd06bb2e06
243 changed files with 50805 additions and 175 deletions

View file

@ -0,0 +1,334 @@
version: "1.0"
last_updated: "2025-12-16"
agents:
- path: "packages/shared-stores/"
agent_dir: "packages/shared-stores/.agent"
name: "Shared Stores Agent"
watches:
- "packages/shared-stores//**"
- path: "packages/shared-feedback-ui/"
agent_dir: "packages/shared-feedback-ui/.agent"
name: "Agent: Feedback UI Package"
watches:
- "packages/shared-feedback-ui//**"
- path: "packages/nutriphi-database/"
agent_dir: "packages/nutriphi-database/.agent"
name: "NutriPhi Database Expert"
watches:
- "packages/nutriphi-database//**"
- path: "packages/shared-feedback-types/"
agent_dir: "packages/shared-feedback-types/.agent"
name: "Agent: Feedback Types Package"
watches:
- "packages/shared-feedback-types//**"
- path: "packages/shared-help-types/"
agent_dir: "packages/shared-help-types/.agent"
name: "Shared Help Types Expert"
watches:
- "packages/shared-help-types//**"
- path: "packages/shared-i18n/"
agent_dir: "packages/shared-i18n/.agent"
name: "Shared i18n Agent"
watches:
- "packages/shared-i18n//**"
- path: "packages/shared-types/"
agent_dir: "packages/shared-types/.agent"
name: "Shared Types Expert"
watches:
- "packages/shared-types//**"
- path: "packages/shared-help-ui/"
agent_dir: "packages/shared-help-ui/.agent"
name: "Shared Help UI Expert"
watches:
- "packages/shared-help-ui//**"
- path: "packages/shared-subscription-ui/"
agent_dir: "packages/shared-subscription-ui/.agent"
name: "Shared Subscription UI Agent"
watches:
- "packages/shared-subscription-ui//**"
- path: "packages/shared-profile-ui/"
agent_dir: "packages/shared-profile-ui/.agent"
name: "@manacore/shared-profile-ui Agent"
watches:
- "packages/shared-profile-ui//**"
- path: "packages/shared-tailwind/"
agent_dir: "packages/shared-tailwind/.agent"
name: "Agent: @manacore/shared-tailwind"
watches:
- "packages/shared-tailwind//**"
- path: "packages/manadeck-database/"
agent_dir: "packages/manadeck-database/.agent"
name: "ManaDeck Database Expert"
watches:
- "packages/manadeck-database//**"
- path: "packages/shared-supabase/"
agent_dir: "packages/shared-supabase/.agent"
name: "Shared Supabase Expert"
watches:
- "packages/shared-supabase//**"
- path: "packages/shared-vite-config/"
agent_dir: "packages/shared-vite-config/.agent"
name: "Shared Vite Config Agent"
watches:
- "packages/shared-vite-config//**"
- path: "packages/shared-config/"
agent_dir: "packages/shared-config/.agent"
name: "Shared Config Agent"
watches:
- "packages/shared-config//**"
- path: "packages/shared-landing-ui/"
agent_dir: "packages/shared-landing-ui/.agent"
name: "@manacore/shared-landing-ui Agent"
watches:
- "packages/shared-landing-ui//**"
- path: "packages/mana-core-nestjs-integration/"
agent_dir: "packages/mana-core-nestjs-integration/.agent"
name: "Mana Core NestJS Integration Agent"
watches:
- "packages/mana-core-nestjs-integration//**"
- path: "packages/shared-tags/"
agent_dir: "packages/shared-tags/.agent"
name: "Shared Tags Expert"
watches:
- "packages/shared-tags//**"
- path: "packages/shared-utils/"
agent_dir: "packages/shared-utils/.agent"
name: "Shared Utils Agent"
watches:
- "packages/shared-utils//**"
- path: "packages/shared-auth-stores/"
agent_dir: "packages/shared-auth-stores/.agent"
name: "Agent: @manacore/shared-auth-stores"
watches:
- "packages/shared-auth-stores//**"
- path: "packages/shared-theme/"
agent_dir: "packages/shared-theme/.agent"
name: "Agent: @manacore/shared-theme"
watches:
- "packages/shared-theme//**"
- path: "packages/eslint-config/"
agent_dir: "packages/eslint-config/.agent"
name: "ESLint Config Agent"
watches:
- "packages/eslint-config//**"
- path: "packages/shared-credit-service/"
agent_dir: "packages/shared-credit-service/.agent"
name: "Shared Credit Service Agent"
watches:
- "packages/shared-credit-service//**"
- path: "packages/shared-nestjs-auth/"
agent_dir: "packages/shared-nestjs-auth/.agent"
name: "Agent: @manacore/shared-nestjs-auth"
watches:
- "packages/shared-nestjs-auth//**"
- path: "packages/shared-splitscreen/"
agent_dir: "packages/shared-splitscreen/.agent"
name: "@manacore/shared-splitscreen Agent"
watches:
- "packages/shared-splitscreen//**"
- path: "packages/shared-api-client/"
agent_dir: "packages/shared-api-client/.agent"
name: "Shared API Client Expert"
watches:
- "packages/shared-api-client//**"
- path: "packages/uload-database/"
agent_dir: "packages/uload-database/.agent"
name: "ULoad Database Expert"
watches:
- "packages/uload-database//**"
- path: "packages/shared-theme-ui/"
agent_dir: "packages/shared-theme-ui/.agent"
name: "Agent: @manacore/shared-theme-ui"
watches:
- "packages/shared-theme-ui//**"
- path: "packages/shared-icons/"
agent_dir: "packages/shared-icons/.agent"
name: "@manacore/shared-icons Agent"
watches:
- "packages/shared-icons//**"
- path: "packages/shared-errors/"
agent_dir: "packages/shared-errors/.agent"
name: "Shared Errors Agent"
watches:
- "packages/shared-errors//**"
- path: "packages/shared-auth/"
agent_dir: "packages/shared-auth/.agent"
name: "Shared Auth Expert"
watches:
- "packages/shared-auth//**"
- path: "packages/shared-subscription-types/"
agent_dir: "packages/shared-subscription-types/.agent"
name: "Shared Subscription Types Agent"
watches:
- "packages/shared-subscription-types//**"
- path: "packages/shared-help-content/"
agent_dir: "packages/shared-help-content/.agent"
name: "Shared Help Content Expert"
watches:
- "packages/shared-help-content//**"
- path: "packages/test-config/"
agent_dir: "packages/test-config/.agent"
name: "Test Config Agent"
watches:
- "packages/test-config//**"
- path: "packages/shared-storage/"
agent_dir: "packages/shared-storage/.agent"
name: "Shared Storage Agent"
watches:
- "packages/shared-storage//**"
- path: "packages/shared-branding/"
agent_dir: "packages/shared-branding/.agent"
name: "Agent: @manacore/shared-branding"
watches:
- "packages/shared-branding//**"
- path: "packages/shared-help-mobile/"
agent_dir: "packages/shared-help-mobile/.agent"
name: "Shared Help Mobile Expert"
watches:
- "packages/shared-help-mobile//**"
- path: "packages/shared-ui/"
agent_dir: "packages/shared-ui/.agent"
name: "@manacore/shared-ui Agent"
watches:
- "packages/shared-ui//**"
- path: "packages/shared-auth-ui/"
agent_dir: "packages/shared-auth-ui/.agent"
name: "Agent: @manacore/shared-auth-ui"
watches:
- "packages/shared-auth-ui//**"
- path: "packages/better-auth-types/"
agent_dir: "packages/better-auth-types/.agent"
name: "Better Auth Types Agent"
watches:
- "packages/better-auth-types//**"
- path: "packages/news-database/"
agent_dir: "packages/news-database/.agent"
name: "News Database Expert"
watches:
- "packages/news-database//**"
- path: "packages/shared-feedback-service/"
agent_dir: "packages/shared-feedback-service/.agent"
name: "Agent: Feedback Service Package"
watches:
- "packages/shared-feedback-service//**"
- path: "games/worldream/"
agent_dir: "games/worldream/.agent"
name: "Root"
watches:
- "games/worldream//**"
- path: "games/mana-games/"
agent_dir: "games/mana-games/.agent"
name: "Root"
watches:
- "games/mana-games//**"
- path: "games/whopixels/"
agent_dir: "games/whopixels/.agent"
name: "Root"
watches:
- "games/whopixels//**"
- path: "games/figgos/"
agent_dir: "games/figgos/.agent"
name: "Root"
watches:
- "games/figgos//**"
- path: "games/voxelava/"
agent_dir: "games/voxelava/.agent"
name: "Root"
watches:
- "games/voxelava//**"
- path: "apps/calendar/packages/shared/"
agent_dir: "apps/calendar/packages/shared/.agent"
name: "Calendar Shared Package Agent"
watches:
- "apps/calendar/packages/shared//**"
- path: "apps/calendar/"
agent_dir: "apps/calendar/.agent"
name: "Root"
watches:
- "apps/calendar//**"
- path: "apps/context/"
agent_dir: "apps/context/.agent"
name: "Root"
watches:
- "apps/context//**"
- path: "apps/zitare/packages/web-ui/"
agent_dir: "apps/zitare/packages/web-ui/.agent"
name: "Agent: @zitare/web-ui"
watches:
- "apps/zitare/packages/web-ui//**"
- path: "apps/zitare/packages/content/"
agent_dir: "apps/zitare/packages/content/.agent"
name: "@zitare/content - Static Content Data Package"
watches:
- "apps/zitare/packages/content//**"
- path: "apps/zitare/packages/shared/"
agent_dir: "apps/zitare/packages/shared/.agent"
name: "Agent: @zitare/shared"
watches:
- "apps/zitare/packages/shared//**"
- path: "apps/zitare/"
agent_dir: "apps/zitare/.agent"
name: "Root"
watches:
- "apps/zitare//**"
- path: "apps/chat/packages/chat-types/"
agent_dir: "apps/chat/packages/chat-types/.agent"
name: "Chat Types Package Agent"
watches:
- "apps/chat/packages/chat-types//**"
- path: "apps/chat/"
agent_dir: "apps/chat/.agent"
name: "Root"
watches:
- "apps/chat//**"
- path: "apps/contacts/"
agent_dir: "apps/contacts/.agent"
name: "Root"
watches:
- "apps/contacts//**"
- path: "apps/picture/packages/mobile-ui/"
agent_dir: "apps/picture/packages/mobile-ui/.agent"
name: "Mobile UI Package Agent"
watches:
- "apps/picture/packages/mobile-ui//**"
- path: "apps/picture/packages/shared/"
agent_dir: "apps/picture/packages/shared/.agent"
name: "Shared Package Agent"
watches:
- "apps/picture/packages/shared//**"
- path: "apps/picture/packages/design-tokens/"
agent_dir: "apps/picture/packages/design-tokens/.agent"
name: "Design Tokens Package Agent"
watches:
- "apps/picture/packages/design-tokens//**"
- path: "apps/picture/"
agent_dir: "apps/picture/.agent"
name: "Root"
watches:
- "apps/picture//**"
- path: "apps/todo/packages/shared/"
agent_dir: "apps/todo/packages/shared/.agent"
name: "Todo Shared Expert"
watches:
- "apps/todo/packages/shared//**"
- path: "apps/todo/"
agent_dir: "apps/todo/.agent"
name: "Root"
watches:
- "apps/todo//**"
- path: "apps/clock/packages/shared/"
agent_dir: "apps/clock/packages/shared/.agent"
name: "Clock Shared Package Agent"
watches:
- "apps/clock/packages/shared//**"
- path: "apps/clock/"
agent_dir: "apps/clock/.agent"
name: "Root"
watches:
- "apps/clock//**"
- path: "services/mana-core-auth/"
agent_dir: "services/mana-core-auth/.agent"
name: "Root"
watches:
- "services/mana-core-auth//**"

0
.knowledge/changes.jsonl Normal file
View file

View file

@ -0,0 +1,247 @@
# Initialize Agent Knowledge System
You are helping set up an AI agent knowledge system for this codebase. Your task is to analyze each module and create rich, domain-specific agent files.
## What You Need To Do
For each module listed below, you need to:
1. **Read the module's code** - Look at package.json, README, src/ structure, key files
2. **Understand its purpose** - What does it do? How is it used?
3. **Create agent files** - Write .agent/agent.md (and team files for apps)
## Modules to Process
### Apps (14) - Create standard team for each
- `apps/calendar`
- `apps/chat`
- `apps/clock`
- `apps/contacts`
- `apps/context`
- `apps/picture`
- `apps/todo`
- `apps/zitare`
- `games/figgos`
- `games/mana-games`
- `games/voxelava`
- `games/whopixels`
- `games/worldream`
- `services/mana-core-auth`
### Packages (52) - Create single agent for each
- `apps/chat/packages/chat-types`
- `apps/zitare/packages/content`
- `apps/calendar/packages/shared`
- `apps/clock/packages/shared`
- `apps/picture/packages/design-tokens`
- `apps/picture/packages/mobile-ui`
- `apps/picture/packages/shared`
- `apps/todo/packages/shared`
- `apps/zitare/packages/shared`
- `apps/zitare/packages/web-ui`
- `packages/better-auth-types`
- `packages/eslint-config`
- `packages/mana-core-nestjs-integration`
- `packages/manadeck-database`
- `packages/news-database`
- `packages/nutriphi-database`
- `packages/shared-api-client`
- `packages/shared-auth`
- `packages/shared-auth-stores`
- `packages/shared-auth-ui`
- `packages/shared-branding`
- `packages/shared-config`
- `packages/shared-credit-service`
- `packages/shared-errors`
- `packages/shared-feedback-service`
- `packages/shared-feedback-types`
- `packages/shared-feedback-ui`
- `packages/shared-help-content`
- `packages/shared-help-mobile`
- `packages/shared-help-types`
- `packages/shared-help-ui`
- `packages/shared-i18n`
- `packages/shared-icons`
- `packages/shared-landing-ui`
- `packages/shared-nestjs-auth`
- `packages/shared-profile-ui`
- `packages/shared-splitscreen`
- `packages/shared-storage`
- `packages/shared-stores`
- `packages/shared-subscription-types`
- `packages/shared-subscription-ui`
- `packages/shared-supabase`
- `packages/shared-tags`
- `packages/shared-tailwind`
- `packages/shared-theme`
- `packages/shared-theme-ui`
- `packages/shared-types`
- `packages/shared-ui`
- `packages/shared-utils`
- `packages/shared-vite-config`
- `packages/test-config`
- `packages/uload-database`
## Team Template: standard
Roles to create for each app:
### 📋 Product Owner (`product-owner.md`)
Voice of the customer. Defines requirements, prioritizes features, writes user stories, and ensures product delivers value.
### 🏗️ Architect (`architect.md`)
Designs system structure, makes technology decisions, defines patterns, and ensures scalability and maintainability.
### 👨‍💻 Senior Developer (`senior-dev.md`)
Experienced developer who tackles complex features, reviews code, mentors juniors, and establishes best practices.
### 💻 Developer (`developer.md`)
Implements features, fixes bugs, writes tests, and follows the patterns established by seniors.
### 🔒 Security Engineer (`security.md`)
Security expert who reviews code for vulnerabilities, ensures auth is solid, and protects user data.
### 🧪 QA Lead (`qa-lead.md`)
Leads testing strategy, plans test coverage, coordinates QA efforts, and ensures quality gates are met.
## Agent File Format
### For Packages (single agent)
Create `{path}/.agent/agent.md`:
```markdown
# {Module Name} Expert
## Module: {name}
**Path:** `{path}`
**Description:** {Your analysis of what this module does}
**Tech Stack:** {Detected technologies}
**Key Dependencies:** {Important deps}
## Identity
You are the **{Module Name} Expert**. You have deep knowledge of:
- {Key thing 1 this module handles}
- {Key thing 2}
- {Integration patterns with other modules}
## Expertise
- {Domain expertise 1}
- {Domain expertise 2}
- {Domain expertise 3}
## Code Structure
\`\`\`
{path}/src/
├── {folder1}/ # {what it contains}
├── {folder2}/ # {what it contains}
\`\`\`
## Key Patterns
- {Important pattern 1 used in this module}
- {Important pattern 2}
## Integration Points
- Used by: {list apps/packages that depend on this}
- Depends on: {list dependencies}
## How to Use
\`\`\`
"Read {path}/.agent/ and help me with..."
\`\`\`
```
Also create `{path}/.agent/memory.md`:
```markdown
# {Module Name} Expert - Memory
Auto-updated with learnings from code changes.
## Recent Updates
_No updates yet._
```
### For Apps (team)
Create `{path}/.agent/team/{role-id}.md` for each role:
```markdown
# {Role Name}
## Module: {app name}
**Path:** `{path}`
**Description:** {Your analysis}
**Tech Stack:** {Technologies}
**Platforms:** {Backend, Mobile, Web, etc.}
## Identity
{Role-specific identity based on what this app does}
## Responsibilities
- {Responsibility 1 specific to this app}
- {Responsibility 2}
## Domain Knowledge
{What this role needs to know about this specific app}
## Key Areas
- {Area 1 this role focuses on}
- {Area 2}
## How to Invoke
\`\`\`
"As the {Role} for {app}, help me with..."
\`\`\`
```
Also create `{path}/.agent/team.md` with team overview.
## Instructions
1. Start with the most important modules first (shared-auth, shared-api-client, core apps)
2. For each module:
- Read its package.json, README.md, and browse src/
- Understand what it does and how it's used
- Write the agent files with YOUR analysis (not just copying README)
3. Make the descriptions actionable - what would a developer need to know?
4. Include integration points - how does this module connect to others?
## Start Now
Begin by analyzing the first few high-priority modules:
1. `packages/shared-auth` - Authentication (critical)
2. `packages/shared-api-client` - API client (used everywhere)
3. `apps/chat` - Main chat application
For each one:
1. Read the code
2. Write the agent files
3. Move to the next
Say "I'll start analyzing the modules now" and begin with shared-auth.