Skip to content

feat(rules): add Pool (Poolside) as a rules target - #2976

Open
Fe2-O3 wants to merge 1 commit into
dyoshikawa:mainfrom
Fe2-O3:feat/pool-rules
Open

feat(rules): add Pool (Poolside) as a rules target#2976
Fe2-O3 wants to merge 1 commit into
dyoshikawa:mainfrom
Fe2-O3:feat/pool-rules

Conversation

@Fe2-O3

@Fe2-O3 Fe2-O3 commented Sep 8, 2026

Copy link
Copy Markdown

Refs #2945.

Adds Pool (Poolside's coding agent CLI, pool) as a rulesync rules target. Pool reads AGENTS.md at personal, project, and nested per-directory scopes, so this target:

  • writes the root rule to AGENTS.md (project) / ~/.config/poolside/AGENTS.md (global, via --global, honouring XDG_CONFIG_HOME)
  • folds plain non-root rules into that single root file (no modular rules directory)
  • emits directory-scoped rules (agentsmd.subprojectPath) as nested <dir>/AGENTS.md (project scope only)
  • imports nested files back through the shared AGENTS.md helper, so one rulesync rule per subproject no matter which AGENTS.md-family target discovered it

Scope note: this PR covers rules only. Per the mapping in #2945, skills (Agent Skills spec dirs), mcp (mcp_servers: in settings.yaml), permissions (tools:/paths:), hooks (hooks:), and subagents (subagents:) are natural follow-ups; commands (built-in only) and ignore (no public spec) are out. Happy to follow up with skills/MCP next, or to split this further if preferred.

Verified against https://docs.poolside.ai/agent-instructions and a local read of the pool 1.0.14 config surface described in #2945.

Verification

  • New PoolRule unit tests: 10 passed
  • Full unit suite: 412 files, 11163 passed, 3 skipped
  • E2E rules (incl. new pool generate/import/global entries): 144 passed
  • pnpm run check (format, lint, typecheck): clean
  • pnpm run cicheck:content (docs-content, gitignore, supported-tools, cspell, secretlint): clean
  • Real CLI smoke: pnpm dev generate --targets pool --features rules --dry-run resolves to AGENTS.md
  • Generated tables (pnpm run generate:tables, generate:docs-content, dev gitignore) applied; hand-written file-formats.md Pool note added

Pool reads AGENTS.md at personal (~/.config/poolside/AGENTS.md),
project-root, and nested per-directory scopes, so plain topic rules
fold into the root file while directory-scoped rules
(agentsmd.subprojectPath) emit nested <dir>/AGENTS.md files.

Refs dyoshikawa#2945
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants