Skip to content

Commit a3a4a33

Browse files
committed
docs: regenerate AGENTS.md with updated project knowledge
- Fixed agent name OmO → Sisyphus - Added CI PIPELINE section documenting workflow patterns - Fixed testing documentation (Bun test framework with BDD pattern) - Added README.zh-cn.md to multi-language docs list - Added `bun test` command to COMMANDS section - Added anti-patterns: Over-exploration, Date references - Updated convention: Test style with BDD comments - Added script/generate-changelog.ts to structure - Updated timestamp (2025-12-22) and git commit reference (aad7a72) 🤖 GENERATED WITH ASSISTANCE OF [OhMyOpenCode](https://github.com/code-yeongyu/oh-my-opencode)
1 parent 858e3d5 commit a3a4a33

File tree

1 file changed

+22
-9
lines changed

1 file changed

+22
-9
lines changed

AGENTS.md

Lines changed: 22 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# PROJECT KNOWLEDGE BASE
22

3-
**Generated:** 2025-12-16T16:00:00+09:00
4-
**Commit:** a2d2109
5-
**Branch:** master
3+
**Generated:** 2025-12-22T02:23:00+09:00
4+
**Commit:** aad7a72
5+
**Branch:** dev
66

77
## OVERVIEW
88

@@ -13,16 +13,16 @@ OpenCode plugin implementing Claude Code/AmpCode features. Multi-model agent orc
1313
```
1414
oh-my-opencode/
1515
├── src/
16-
│ ├── agents/ # AI agents (OmO, oracle, librarian, explore, frontend, document-writer, multimodal-looker)
16+
│ ├── agents/ # AI agents (Sisyphus, oracle, librarian, explore, frontend, document-writer, multimodal-looker)
1717
│ ├── hooks/ # 21 lifecycle hooks (comment-checker, rules-injector, keyword-detector, etc.)
1818
│ ├── tools/ # LSP (11), AST-Grep, Grep, Glob, background-task, look-at, skill, slashcommand, interactive-bash, call-omo-agent
1919
│ ├── mcp/ # MCP servers (context7, websearch_exa, grep_app)
20-
│ ├── features/ # Terminal, Background agent, Claude Code loaders (agent, command, skill, mcp, session-state), hook-message-injector
20+
│ ├── features/ # Background agent, Claude Code loaders (agent, command, skill, mcp, session-state), hook-message-injector
2121
│ ├── config/ # Zod schema, TypeScript types
2222
│ ├── auth/ # Google Antigravity OAuth
2323
│ ├── shared/ # Utilities (deep-merge, pattern-matcher, logger, etc.)
2424
│ └── index.ts # Main plugin entry (OhMyOpenCodePlugin)
25-
├── script/ # build-schema.ts, publish.ts
25+
├── script/ # build-schema.ts, publish.ts, generate-changelog.ts
2626
├── assets/ # JSON schema
2727
└── dist/ # Build output (ESM + .d.ts)
2828
```
@@ -52,6 +52,7 @@ oh-my-opencode/
5252
- **Directory naming**: kebab-case (`ast-grep/`, `claude-code-hooks/`)
5353
- **Tool structure**: Each tool has index.ts, types.ts, constants.ts, tools.ts, utils.ts
5454
- **Hook pattern**: `createXXXHook(input: PluginInput)` returning event handlers
55+
- **Test style**: BDD comments `#given`, `#when`, `#then` (same as AAA pattern)
5556

5657
## ANTI-PATTERNS (THIS PROJECT)
5758

@@ -63,6 +64,7 @@ oh-my-opencode/
6364
- **Local version bump**: Version managed by CI workflow, never modify locally
6465
- **Rush completion**: Never mark tasks complete without verification
6566
- **Interrupting work**: Complete tasks fully before stopping
67+
- **Over-exploration**: Stop searching when sufficient context found
6668

6769
## UNIQUE STYLES
6870

@@ -73,12 +75,13 @@ oh-my-opencode/
7375
- **Agent tools restriction**: Use `tools: { include: [...] }` or `tools: { exclude: [...] }`
7476
- **Temperature**: Most agents use `0.1` for consistency
7577
- **Hook naming**: `createXXXHook` function naming convention
78+
- **Date references**: NEVER use 2024 in code/prompts (use current year)
7679

7780
## AGENT MODELS
7881

7982
| Agent | Model | Purpose |
8083
|-------|-------|---------|
81-
| OmO | anthropic/claude-opus-4-5 | Primary orchestrator, team leader |
84+
| Sisyphus | anthropic/claude-opus-4-5 | Primary orchestrator, team leader |
8285
| oracle | openai/gpt-5.2 | Strategic advisor, code review, architecture |
8386
| librarian | anthropic/claude-sonnet-4-5 | Multi-repo analysis, docs lookup, GitHub examples |
8487
| explore | opencode/grok-code | Fast codebase exploration, file patterns |
@@ -100,6 +103,9 @@ bun run rebuild
100103

101104
# Build schema only
102105
bun run build:schema
106+
107+
# Run tests
108+
bun test
103109
```
104110

105111
## DEPLOYMENT
@@ -124,11 +130,18 @@ gh run list --workflow=publish
124130
- Never run `bun publish` directly (OIDC provenance issue)
125131
- Never bump version locally
126132

133+
## CI PIPELINE
134+
135+
- **ci.yml**: Parallel test/typecheck jobs, build verification, auto-commit schema changes on master
136+
- **publish.yml**: Manual workflow_dispatch, version bump, changelog generation, OIDC npm publishing
137+
- Schema auto-commit prevents build drift
138+
- Draft release creation on dev branch
139+
127140
## NOTES
128141

129-
- **No tests**: Test framework not configured
142+
- **Testing**: Bun native test framework (`bun test`), BDD-style with `#given/#when/#then` comments
130143
- **OpenCode version**: Requires >= 1.0.150 (earlier versions have config bugs)
131-
- **Multi-language docs**: README.md (EN), README.ko.md (KO), README.ja.md (JA)
144+
- **Multi-language docs**: README.md (EN), README.ko.md (KO), README.ja.md (JA), README.zh-cn.md (ZH-CN)
132145
- **Config locations**: `~/.config/opencode/oh-my-opencode.json` (user) or `.opencode/oh-my-opencode.json` (project)
133146
- **Schema autocomplete**: Add `$schema` field in config for IDE support
134147
- **Trusted dependencies**: @ast-grep/cli, @ast-grep/napi, @code-yeongyu/comment-checker

0 commit comments

Comments
 (0)