Confluence init

AGENTS.md

@@ -62,47 +62,53 @@
 * Be concise
 * Do not explain obvious things
 * Do not produce long texts
-* Prefer action over discussion when safe
+* Prefer action when no clarification is needed
+
+---
 
 ### QUESTIONS
 
-Ask ONLY if:
+Default:
 
-* Multiple valid solutions AND impact is significant
-* Requirements are unclear
-* User must choose between explicit options
+* If result can be improved by user choice → ASK FIRST
+* Do not execute immediately if preferences affect result
+
+Ask BEFORE action if:
+
+* Multiple valid directions exist
+* Result depends on user preference
+* Request is broad (e.g. "suggest", "recommend", "generate")
 
 Otherwise:
 
 * Proceed with best reasonable assumption
 
-MAXIMIZE USE OF `question` TOOL:
-
-* Всегда используй `question` когда есть 2+ варианта выбора
-* Применяй для архитектурных решений, конфигов, данных, внешнего поведения
-* Предлагай явные варианты с краткими описаниями
-* Не переходи к действию без явного выбора по значимым вопросам
+---
 
 ### QUESTION TOOL
 
-`question` is the UI tool for showing questions to the user in OpenCode.
+`question` is the UI tool for user choices in OpenCode.
 
-Use `question` when:
+Use `question` BEFORE answering when:
 
-* the user must choose between 2+ options
-* confirmation affects architecture, config, data, or external behavior
-* the choice should be presented as explicit selectable variants
+* 2+ meaningful options exist
+* clarification improves result quality
+* choice affects architecture, config, data, or output
 
-Do not use `question` when:
+Do NOT skip `question` in these cases.
 
-* the answer can be inferred safely
-* the issue is minor
-* no real choice exists
+Do NOT use when:
 
-If `question` is unavailable:
+* request is already specific
+* only one valid answer exists
+* clarification does not change result
+
+If unavailable:
 
 * ask in plain text
 
+---
+
 ### RESTRICTIONS
 
 * Do not end with only a question
@@ -111,21 +117,40 @@ If `question` is unavailable:
 
 ---
 
+## TOOLS
+
+Always assume tools MAY be available.
+
+Before solving:
+
+* Identify relevant tools
+* Prefer tools when they simplify the task
+
+Rules:
+
+* Do not invent tools
+* Use only confirmed available tools
+* If availability unclear → proceed without them
+
+Tools are part of the solution, not optional.
+
+---
+
 ## MEMORY
 
 Use ONLY if memory tools are available.
 
 ### READ FIRST
 
-Before coding or making assumptions:
+Before coding or assumptions:
 
 1. Try `read_graph`
-2. If needed, try `search_nodes()`
-3. Do not duplicate existing observations
+2. Then `search_nodes()`
+3. Avoid duplicate observations
 
-If tools are unavailable:
+If unavailable:
 
-* Skip memory operations
+* Skip memory usage
 
 ### KEY FORMAT
 
@@ -152,8 +177,6 @@ lazybear/config/jira-base-url
 
 ### WRITE ONLY WHEN USEFUL
 
-Create or update memory for:
-
 * architecture changes → `architecture`
 * new MCP tools → `mcp_tool`
 * major decisions → `decision`
@@ -165,8 +188,8 @@ Create or update memory for:
 
 * One entity = one type
 * Keep entries short
-* Do not duplicate observations
-* Do not write memory for trivial edits
+* Do not duplicate
+* Skip trivial changes
 
 ---
 
@@ -198,17 +221,25 @@ External:
 ## EDITING RULES
 
 * Do not modify this file unless asked
-* Do not change structure without need
+* Do not change structure
 * Keep instructions short and explicit
 
 ---
 
 ## CORE BEHAVIOR
 
-* Act first, ask only when needed
-* Use `question` for explicit user-facing choices in OpenCode
-* Prefer safe assumptions
+* Ask first if it improves result quality
+
+* Otherwise act
+
+* Always consider tools before solving
+
+* Prefer tools when useful
+
 * Minimal changes only
+
 * Do not invent tools
+
 * Use tools only if confirmed available
+
 * Never leak secrets