Initial commit with translated description

references/command-cheatsheet.md

@@ -0,0 +1,13 @@
+## Core Opencode commands
+
+- Start Opencode:
+  opencode
+
+- Session selection:
+  /sessions
+
+- Agent (mode) selection:
+  /agents
+
+- Model selection:
+  /models

references/failure-handling.md

@@ -0,0 +1,13 @@
+## Common failures and responses
+
+### Login link does not work
+- Ask the user to retry
+- Do not proceed without confirmation
+
+### Model not available
+- Inform the user
+- Ask for an alternative provider
+
+### Plan is unclear or contradictory
+- Ask Opencode to rewrite the plan
+- Do not switch to Build mode

references/model-selection.md

@@ -0,0 +1,15 @@
+## Model selection procedure
+
+- Open model selector with:
+  /models
+
+- Select the provider requested by the user
+
+### Auth-based providers (e.g. OpenAI)
+
+- Opencode will generate a login URL
+- Copy the URL exactly
+- Send it to the user
+- Wait for confirmation before continuing
+
+Never assume authentication is complete.

references/plan-vs-build.md

@@ -0,0 +1,17 @@
+## Plan mode
+
+- Thinking only
+- Planning
+- Asking questions
+- Revising approach
+- No code generation
+
+## Build mode
+
+- Code implementation
+- Execution of approved plan
+
+### Mode switching
+
+- Use the Tab key to toggle modes
+- Always start in Plan mode

references/question-handling.md

@@ -0,0 +1,8 @@
+## Handling questions from Opencode
+
+- If Opencode asks a question:
+  - Switch to Plan mode immediately
+  - Answer carefully
+  - Confirm or revise the plan
+
+Never answer questions in Build mode.

references/session-management.md

@@ -0,0 +1,10 @@
+## Session rules
+
+- Opencode keeps a history of projects
+- The same project must always use the same session
+- Reusing sessions preserves context and decisions
+- Starting a new session is allowed only if the user explicitly asks
+- Open session selector using:
+  /sessions
+
+If unsure, ask the user before creating a new session.

references/workflow.md

@@ -0,0 +1,12 @@
+## Standard workflow
+
+1. Confirm AI provider and auth method with the user
+2. Start Opencode
+3. Reuse existing project session if present
+4. Select AI model using `/models`
+5. Ensure Plan mode
+6. Generate and validate plan
+7. Switch to Build mode
+8. Implement
+9. Handle interruptions by returning to Plan mode
+10. Repeat until finished