docs: add console logging rule — app().log only, console for startup only

[four-bytes-robby]

Changes

Added console logging convention to AGENTS.md.

Rule

Plugins MUST use _client?.app?.log() for all logging in plugin mode — console.log / console.warn / console.error is ONLY permitted for the initial startup "init" message. Console output in plugin mode breaks the terminal UI.

---

Summary by cubic

Documented console logging rule: plugins must use _client?.app?.log() in plugin mode; console.log / console.warn / console.error are only allowed for the startup "init" message to avoid breaking the terminal UI.
Also updated references to the central standards path to ~/ai-shared-rules/AGENTS.md.

^{Written for commit 3968911. Summary will update on new commits.}

Summary by CodeRabbit

• Documentation
  • Updated AI agent guidelines with revised shared standards references and plugin development practices.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

Recent review info

Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0e7c554b-392f-45a7-bef3-9303f5403789

Commits

Reviewing files that changed from the base of the PR and between e4dfe9b and 3968911.

Files selected for processing (1)

• AGENTS.md

---

Walkthrough

Walkthrough

AGENTS.md is updated in two ways: the shared standards file reference path is changed from ~/.personal-config/ai-shared/AGENTS.md to ~/ai-shared-rules/AGENTS.md in two locations, and a new mandatory rule is added requiring plugin-mode code to use _client?.app?.log() for all logging, with console.log/warn/error permitted only for the initial "init" startup message.

Changes

AGENTS.md updates

Layer / File(s)	Summary
Shared standards path update and plugin logging constraint AGENTS.md	Two occurrences of the old ~/.personal-config/ai-shared/AGENTS.md path are replaced with ~/ai-shared-rules/AGENTS.md, and a new mandatory rule is added specifying that plugin mode must use _client?.app?.log() for all logging, restricting console.log/warn/error to only the initial "init" message.

Estimated code review effort

3 (Moderate) | ~15 minutes

Possibly related issues

• [FIX] logger.ts outputs to console in plugin mode — breaks TUI four-opencode-brain#172: The new mandatory logging constraint added in this PR (restricting console.log/warn/error to the "init" message and requiring _client?.app?.log() in plugin mode) directly documents the workflow rule that issue tracks for implementation in logger.ts.

Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: adding a console logging rule that requires app().log() for plugin logging and restricts console methods to startup only.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{Tip: You can configure your own custom pre-merge checks in the settings.}

Finishing Touches

Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/add-console-logging-rule

Simplify code

• Create PR with simplified code
• Commit simplified code in branch docs/add-console-logging-rule

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[cubic-dev-ai]

No issues found across 1 file

_{Re-trigger cubic}