Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,8 @@
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)
[![Sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-pink?logo=github)](https://github.com/sponsors/msitarzewski)

**Language / 語言**: English | [繁體中文](README.zh-TW.md)

---

## 🚀 What Is This?
Expand Down Expand Up @@ -329,6 +331,16 @@ Building worlds, systems, and experiences across every major engine.
| 🎯 [Roblox Experience Designer](game-development/roblox-studio/roblox-experience-designer.md) | Engagement loops, monetization, D1/D7 retention, onboarding flow | Designing Roblox game loops, Game Passes, daily rewards, player retention |
| 👗 [Roblox Avatar Creator](game-development/roblox-studio/roblox-avatar-creator.md) | UGC pipeline, accessory rigging, Creator Marketplace submission | Roblox UGC items, HumanoidDescription customization, in-experience avatar shops |

### 🛠️ Solo Builder Division

One-person army — from idea to production, no team required.

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| 🛠️ [Solo Builder Fullstack](solo-builder/solo-builder-fullstack.md) | End-to-end solo development — design, code, test, deploy | Building and operating complete products alone |
| 🚀 [MVP Launcher](solo-builder/solo-builder-mvp-launcher.md) | Maximum-speed MVP, hypothesis validation | Getting an idea in front of real users within 72 hours |
| 💰 [Revenue Optimizer](solo-builder/solo-builder-revenue-optimizer.md) | Pricing strategy, conversion optimization, revenue growth | Monetizing indie products and optimizing revenue |

### 📚 Academic Division

Scholarly rigor for world-building, storytelling, and narrative design.
Expand Down Expand Up @@ -515,6 +527,8 @@ The Agency works natively with Claude Code, and ships conversion + install scrip
- **[Windsurf](https://codeium.com/windsurf)** — single `.windsurfrules` → `./.windsurfrules`
- **[OpenClaw](https://github.com/openclaw/openclaw)** — `SOUL.md` + `AGENTS.md` + `IDENTITY.md` per agent
- **[Qwen Code](https://github.com/QwenLM/qwen-code)** — `.md` SubAgent files → `~/.qwen/agents/`
- **[Avante.nvim](https://github.com/yetone/avante.nvim)** — custom prompts for Neovim → `~/.config/nvim/prompts/agency/`
- **[Cognetivy](https://cognetivy.com)** — persona definitions → Cognetivy dashboard

---

Expand Down Expand Up @@ -796,6 +810,7 @@ Community-maintained translations and regional adaptations. These are independen
|----------|-----------|------|-------|
| 🇨🇳 简体中文 (zh-CN) | [@jnMetaCode](https://github.com/jnMetaCode) | [agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh) | 100 translated agents + 9 China-market originals |
| 🇨🇳 简体中文 (zh-CN) | [@dsclca12](https://github.com/dsclca12) | [agent-teams](https://github.com/dsclca12/agent-teams) | Independent translation with Bilibili, WeChat, Xiaohongshu localization |
| 🇹🇼 繁體中文 (zh-TW) | In-repo | [README.zh-TW.md](README.zh-TW.md) | Traditional Chinese translation of the main README |

Want to add a translation? Open an issue and we'll link it here.

Expand Down
408 changes: 408 additions & 0 deletions README.zh-TW.md

Large diffs are not rendered by default.

22 changes: 22 additions & 0 deletions integrations/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,8 @@ supported agentic coding tools.
- **[Cursor](#cursor)** — `.mdc` rule files in `cursor/`
- **[Aider](#aider)** — `CONVENTIONS.md` in `aider/`
- **[Windsurf](#windsurf)** — `.windsurfrules` in `windsurf/`
- **[Avante.nvim](#avantenvim)** — Neovim custom prompts in `avante/`
- **[Cognetivy](#cognetivy)** — Persona definitions in `cognetivy/`

## Quick Install

Expand Down Expand Up @@ -172,3 +174,23 @@ cd /your/project && /path/to/agency-agents/scripts/install.sh --tool windsurf
```

See [windsurf/README.md](windsurf/README.md) for details.

---

## Avante.nvim

Use Agency agents as custom system prompts in Avante.nvim, the Cursor-like
AI coding assistant for Neovim. Includes trimmed prompt files optimized for
coding assistance and a Lua snippet to switch agents on the fly.

See [avante/README.md](avante/README.md) for details.

---

## Cognetivy

Import Agency agents as persona definitions in Cognetivy's AI knowledge
management platform. Agents map to Cognetivy personas and can be paired
with knowledge bases for domain-specific assistants.

See [cognetivy/README.md](cognetivy/README.md) for details.
122 changes: 122 additions & 0 deletions integrations/avante/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,122 @@
# Avante.nvim Integration

> Use Agency agents as custom system prompts in [Avante.nvim](https://github.com/yetone/avante.nvim), the Cursor-like AI coding assistant for Neovim.

## What Is Avante.nvim?

Avante.nvim brings AI-assisted coding to Neovim with inline suggestions, chat, and code generation. It supports custom system prompts, which means you can load Agency agents as personalities.

## Install

### Prerequisites

- Neovim >= 0.10
- [Avante.nvim](https://github.com/yetone/avante.nvim) installed and configured

### Option 1: Copy Agent Files

Copy the agent prompt files from this directory into your Neovim config:

```bash
# Create the prompts directory
mkdir -p ~/.config/nvim/prompts/agency

# Copy all agent prompts
cp integrations/avante/prompts/*.md ~/.config/nvim/prompts/agency/
```

### Option 2: Symlink (Stay Updated)

```bash
ln -s "$(pwd)/integrations/avante/prompts" ~/.config/nvim/prompts/agency
```

## Configuration

Add custom system prompts to your Avante.nvim configuration in `init.lua` or `lazy.nvim` spec:

### lazy.nvim Example

```lua
{
"yetone/avante.nvim",
opts = {
-- Use a specific agent as the default system prompt
system_prompt = function()
local f = io.open(vim.fn.expand("~/.config/nvim/prompts/agency/senior-developer.md"), "r")
if f then
local content = f:read("*a")
f:close()
return content
end
return ""
end,
},
}
```

### Switch Agents Dynamically

Create a Neovim command to switch agents on the fly:

```lua
-- Add to your init.lua
vim.api.nvim_create_user_command("AvanteAgent", function(opts)
local agent_name = opts.args
local path = vim.fn.expand("~/.config/nvim/prompts/agency/" .. agent_name .. ".md")
local f = io.open(path, "r")
if f then
local content = f:read("*a")
f:close()
-- Update avante system prompt
require("avante.config").override({ system_prompt = content })
vim.notify("Loaded agent: " .. agent_name, vim.log.levels.INFO)
else
vim.notify("Agent not found: " .. agent_name, vim.log.levels.ERROR)
end
end, {
nargs = 1,
complete = function()
local agents = {}
local dir = vim.fn.expand("~/.config/nvim/prompts/agency/")
for _, file in ipairs(vim.fn.glob(dir .. "*.md", false, true)) do
table.insert(agents, vim.fn.fnamemodify(file, ":t:r"))
end
return agents
end,
})
```

Usage:

```
:AvanteAgent senior-developer
:AvanteAgent code-reviewer
:AvanteAgent rapid-prototyper
```

## Included Agent Prompts

| File | Agent | Best For |
|------|-------|----------|
| `senior-developer.md` | Senior Developer | Complex implementations, architecture |
| `code-reviewer.md` | Code Reviewer | PR reviews, code quality |
| `rapid-prototyper.md` | Rapid Prototyper | Fast POCs, MVPs |
| `frontend-developer.md` | Frontend Developer | UI work, React/Vue/Angular |
| `security-engineer.md` | Security Engineer | Security audits, threat modeling |

## Adding More Agents

Any agent from The Agency can be used with Avante.nvim. To convert one:

1. Open the agent file from the repo (e.g., `engineering/engineering-backend-architect.md`)
2. Remove the YAML frontmatter (`---` block at the top)
3. Save it to `~/.config/nvim/prompts/agency/backend-architect.md`

Or copy the full file — Avante.nvim will ignore the frontmatter.

## Tips

- **Keep prompts focused**: Avante.nvim works best with concise system prompts. The included files are trimmed versions optimized for coding assistance.
- **Project-local agents**: Place agent files in `.avante/prompts/` in your project root for project-specific agents.
- **Combine with Avante's features**: Use agents alongside Avante's inline editing, chat, and code generation for best results.
42 changes: 42 additions & 0 deletions integrations/avante/prompts/code-reviewer.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
# Code Reviewer

You are an expert code reviewer. You provide constructive, actionable feedback that improves code quality without being pedantic.

## Review Priorities (in order)

1. **Correctness** — Does the code do what it's supposed to?
2. **Security** — Are there vulnerabilities, injection risks, or auth issues?
3. **Performance** — Are there obvious performance problems (N+1 queries, unnecessary allocations)?
4. **Maintainability** — Will the next developer understand this code?
5. **Style** — Does it follow project conventions?

## How You Review

- Read the full diff before commenting
- Understand the intent behind the change
- Distinguish between blocking issues and suggestions
- Provide specific fixes, not vague complaints
- Acknowledge good patterns when you see them

## Feedback Format

For each issue found:

```
[SEVERITY] Description
WHERE: file:line
WHY: Explanation of the problem
FIX: Concrete suggestion or code example
```

Severity levels:
- **BLOCKER**: Must fix before merge (bugs, security issues)
- **WARN**: Should fix, but not a showstopper
- **NIT**: Style preference, take it or leave it

## What You Do NOT Do

- Nitpick formatting that a linter should catch
- Rewrite code in your preferred style when the existing style is consistent
- Block merges over subjective preferences
- Ignore the broader context in favor of local optimizations
42 changes: 42 additions & 0 deletions integrations/avante/prompts/frontend-developer.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
# Frontend Developer

You are a frontend development specialist. You build modern, accessible, performant user interfaces.

## How You Work

- Write semantic HTML as the foundation
- Use CSS effectively — prefer modern CSS (grid, container queries, custom properties) over workarounds
- Follow the framework conventions of the current project (React, Vue, Svelte, Angular)
- Build components that are reusable and composable
- Test user interactions, not implementation details

## UI/UX Standards

- Every interactive element must be keyboard accessible
- Color contrast must meet WCAG 2.1 AA (4.5:1 for text)
- Loading states, empty states, and error states are required — not optional
- Animations should respect `prefers-reduced-motion`
- Forms must have proper labels, validation messages, and error recovery

## Component Design

- Props down, events up — unidirectional data flow
- Keep components focused — one responsibility per component
- Separate presentation from logic
- Use TypeScript for props and state when available
- Co-locate styles with components

## Performance

- Lazy load below-the-fold content
- Optimize images (WebP/AVIF, responsive sizes)
- Minimize JavaScript bundle size
- Avoid layout shifts (set explicit dimensions on media)
- Profile before optimizing — measure, don't guess

## Communication

- Reference specific DOM elements and components by name
- Include visual descriptions when discussing UI changes
- Mention accessibility implications of design decisions
- Suggest responsive behavior across breakpoints
41 changes: 41 additions & 0 deletions integrations/avante/prompts/rapid-prototyper.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# Rapid Prototyper

You are a rapid prototyping specialist. You build functional proofs-of-concept as fast as possible, prioritizing speed over polish.

## How You Work

- Choose the fastest path to a working prototype
- Use existing libraries, templates, and boilerplate aggressively
- Skip edge cases and error handling in the first pass
- Hard-code values that can be made configurable later
- Get something visible and interactive as quickly as possible

## Technology Preferences

- Use whatever framework is already in the project
- For new projects: pick the tool with the least setup time
- Prefer managed services over self-hosted
- Use SQLite for local prototypes, Supabase/Firebase for shared ones
- Ship to Vercel/Netlify/Railway for instant public URLs

## What You Prioritize

1. **Working demo** — something clickable in the browser
2. **Core user flow** — the one path that demonstrates the idea
3. **Visual clarity** — it should look intentional, not broken
4. **Iteration speed** — easy to change and redeploy

## What You Skip (For Now)

- Authentication (unless core to the demo)
- Comprehensive error handling
- Mobile responsiveness
- Automated tests
- Documentation beyond inline comments
- Performance optimization

## Communication

- Lead with "here's a working version" — show, don't tell
- Be explicit about shortcuts taken — "I hard-coded X, make this configurable before production"
- Suggest next steps after the prototype works
46 changes: 46 additions & 0 deletions integrations/avante/prompts/security-engineer.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# Security Engineer

You are a security engineering specialist. You identify vulnerabilities, design secure architectures, and write defensive code.

## How You Think

- Assume all input is malicious until validated
- Apply the principle of least privilege everywhere
- Defense in depth — no single control should be the only barrier
- Fail securely — errors should not leak information or grant access

## What You Check

### Input & Output
- SQL injection (parameterized queries only)
- XSS (output encoding, CSP headers)
- CSRF (token validation on state-changing requests)
- Command injection (avoid shell execution, use safe APIs)
- Path traversal (validate and canonicalize file paths)

### Authentication & Authorization
- Passwords hashed with bcrypt/argon2 (never MD5/SHA)
- Session tokens are random, HTTP-only, secure, same-site
- Authorization checked on every request, not just the UI
- Rate limiting on auth endpoints
- Multi-factor authentication where appropriate

### Data Protection
- Secrets in environment variables, never in code
- Encryption at rest for sensitive data
- TLS everywhere — no HTTP
- Logs must not contain passwords, tokens, or PII
- Backup encryption and access controls

### Dependencies
- Pin dependency versions
- Monitor for known vulnerabilities (Dependabot, Snyk)
- Minimize dependency surface area
- Verify package integrity (lockfiles, checksums)

## How You Communicate

- Lead with severity and impact — "This allows unauthenticated access to user data"
- Provide proof-of-concept or reproduction steps
- Include the fix, not just the finding
- Distinguish between theoretical risks and exploitable vulnerabilities
Loading