@akinet/akidevrule 3.3.1 → 3.5.0

package/skills/akithink/SKILL.md

@@ -1,15 +1,15 @@
 ---
 name: akithink
-description: Structured deep-thinking session between agent and human for important decisions — restate the problem, excavate the goal chain to the ultimate goal, first-principles decomposition (facts/constraints/assumptions), mandatory critique (steelman, inversion, pre-mortem), then converge into a decision record. For big / hard-to-reverse / goal-ambiguous problems — small inline questions are already covered passively by akirule + METHOD-deep-think. Also runnable self-run (non-interactive) when owner-authorized or fired by an `agent.A3` trigger. Recommends running on a top-tier model (Opus/Fable).
+description: Structured deep thinking for decisions — restate the problem, excavate the goal chain to the ultimate goal, first-principles decomposition (facts/constraints/assumptions), mandatory critique (steelman, inversion, pre-mortem), then converge into a decision record. Thinking only: it never edits, runs or ships anything — what happens after the record is decided by the originating turn's class (`agent.A3`), outside this skill. Self-run mode (non-interactive, decide and report) fires on an `agent.A3` deep-think trigger or on owner authorization; trivial two-way-door calls stay inline. Interactive session only when the owner asks for one. Best on a top-tier model (Opus/Fable).
 ---
 
 # akithink — structured deep-thinking session
 
-Invoke with `/akithink`, or when the user explicitly asks for a deep-thinking session on a decision ("let's think this through properly", "hãy tư duy sâu về việc này", "cần một session suy nghĩ kỹ"). This is the **active** consumption mode of `payload/METHOD-deep-think.md` — the same analytical brain that akirule loads passively for ordinary tasks, run here at maximum depth through an interactive protocol.
+The **active** consumption mode of `payload/METHOD-deep-think.md` — the same analytical brain the router loads passively for ordinary tasks, run at maximum depth: interactively when the owner asks for a session, in self-run mode when an `agent.A3` deep-think trigger holds (Invocation scope). It thinks; it never acts (`pattern.A3`).
 
 ## When NOT to use this skill
 
-Small, reversible, low-cost-of-error decisions should just be decided. Casual "should we…?" questions are already handled inline by akirule auto-loading `METHOD-deep-think.md` passively — that is enough for two-way-door decisions. Reach for `/akithink` only when the decision is big, hard to reverse (one-way-door), or the goal itself is still unclear. Do not open a session for something that a one-paragraph answer would resolve.
+Trivial, reversible execution with nothing to decide gets no session — act. An interactive session is reserved for a decision the owner wants to reason through together; a decision that meets an `agent.A3` trigger runs in self-run mode (see Invocation scope), scaled in depth to how hard the decision is to reverse; a two-way-door call is decided inline.
 
 ## Toolbox
 
@@ -50,18 +50,19 @@ Then:
 ## Interaction rules
 
 - **Pacing:** ask 1–2 highest-value questions per turn. `AskUserQuestion` is fine for discrete choices. Never dump a full questionnaire in one turn.
-- **Escape hatch:** the user can say "chốt" (or an equivalent "let's converge/decide now") at any point to jump straight to Phase 5 with whatever has been established so far.
+- **Escape hatch:** the user can ask to converge or decide now, in any wording, at any point to jump straight to Phase 5 with whatever has been established so far.
 - **Anti-sycophancy:** same rule as METHOD Module 3 — do not agree without critique, in any phase.
 - **Anti-overuse guard:** if the problem turns out to be small and reversible once restated in Phase 1, say so and offer to just decide it directly instead of running the full protocol.
 
 ## Self-run mode
 
-Runs all phases without waiting, when the owner authorizes the agent to run it itself (e.g. "tự nạp /akithink", "tự chốt", "cho bạn tự quyết") or when fired by an `agent.A3` deep-think trigger:
+Runs all phases without waiting, when the owner authorizes the agent to decide on its own, in any wording, or when fired by an `agent.A3` deep-think trigger:
 - Phase 1 restatement is written, not confirmed.
 - The Interaction rules pacing (1–2 questions per turn) does not apply — no questions are asked mid-session.
 - Questions reach the owner only via `agent.A3`'s escalation outcomes, never through this skill's own turn-by-turn interaction.
-- Phase 5 converges, acts, and reports the decision block (`agent.A3`'s converged outcome). A decision-record doc per `RULE-docs.md` still applies when the decision is durable.
+- Phase 5 converges and reports the decision block (`agent.A3`'s converged outcome), and the session ends there. This skill thinks and never acts (`pattern.A3`): whether anything is then executed is decided by the class of the originating turn — a task turn proceeds under `agent.A3`, a question turn gets the block and nothing else. A decision-record doc per `RULE-docs.md` still applies when the decision is durable.
 
 ## Invocation scope
 
-Interactive mode is explicit-invoke only — akirule does not auto-trigger the interactive protocol; it is reached only when the user asks for it by name or in equivalent words. Self-run mode above is the exception: it fires from an `agent.A3` trigger or owner authorization, without an explicit `/akithink` invocation. The signals that matter for passive-mode auto-loading live on `METHOD-deep-think.md`.
+- **Self-run — model-invoked, no confirmation.** Fires on an `agent.A3` deep-think trigger (that list is the only trigger list — not restated here), on the router's deep-think-depth line (`akirule`), or on owner authorization. Two-way-door work stays below it: decide inline with `METHOD-deep-think.md` passively.
+- **Interactive — owner-invoked only**, by name or in equivalent words; never auto-started, because it spends the owner's turns.

package/skills/akiflow/scripts/council-cost.sh

@@ -1,4 +0,0 @@
-#!/usr/bin/env bash
-# Transitional Unix wrapper — the Python file is the SSOT (cross-platform, incl. Windows).
-# Kept so existing prompts/docs that name "council-cost.sh" keep working on Unix during the transition.
-exec python3 "$(dirname "$0")/council_cost.py" "$@"

package/skills/akiflow/scripts/council-open.sh

@@ -1,4 +0,0 @@
-#!/usr/bin/env bash
-# Transitional Unix wrapper — the Python file is the SSOT (cross-platform, incl. Windows).
-# Kept so existing prompts/docs that name "council-open.sh" keep working on Unix during the transition.
-exec python3 "$(dirname "$0")/council_open.py" "$@"

package/skills/akiflow/scripts/council-read.sh

@@ -1,4 +0,0 @@
-#!/usr/bin/env bash
-# Transitional Unix wrapper — the Python file is the SSOT (cross-platform, incl. Windows).
-# Kept so existing prompts/docs that name "council-read.sh" keep working on Unix during the transition.
-exec python3 "$(dirname "$0")/council_read.py" "$@"

package/skills/akiflow/scripts/council-verify.sh

@@ -1,4 +0,0 @@
-#!/usr/bin/env bash
-# Transitional Unix wrapper — the Python file is the SSOT (cross-platform, incl. Windows).
-# Kept so existing prompts/docs that name "council-verify.sh" keep working on Unix during the transition.
-exec python3 "$(dirname "$0")/council_verify.py" "$@"

package/skills/akiflow/scripts/scythe.sh

@@ -1,4 +0,0 @@
-#!/usr/bin/env bash
-# Transitional Unix wrapper — the Python file is the SSOT (cross-platform, incl. Windows).
-# Kept so existing prompts/docs that name "scythe.sh" keep working on Unix during the transition.
-exec python3 "$(dirname "$0")/scythe.py" "$@"