feed-the-machine 1.7.2 → 1.7.4

package/ftm-mind/references/orient-protocol.md

@@ -179,16 +179,32 @@ Ask the user only when one of these is true:
 
 - two materially different interpretations are both plausible
 - an external-facing action needs approval
-- a required credential, path, or identifier is missing
+- a required credential, path, or identifier is missing **AND the blackboard has no experience confirming access** (see Blackboard-First Rule below)
 - the user explicitly asked for options before action
-- **the task is medium+ and involves external systems, stakeholder coordination, or unfamiliar code** (see Discovery Interview below)
+- **the task is medium+ and involves external systems, stakeholder coordination, or unfamiliar code** (see Discovery Interview below) **AND the blackboard doesn't already confirm repo-level access**
 
 When asking, ask one focused question with concrete choices.
 
+### Blackboard-First Rule (MANDATORY before any access/auth questions)
+
+**Before asking ANY question about credentials, API access, authorization, permissions, or "do you have access to X" — check the blackboard first.**
+
+1. Read `experiences/index.json`
+2. Look for entries tagged with the current repo name, `api-access`, `full-access`, `credentials`, or the system being asked about (e.g., `freshservice`, `okta`, `jira`)
+3. If a matching experience exists with `confidence >= 0.7`:
+   - **Do NOT ask about access.** The user already established this.
+   - **Do NOT run a discovery interview about authorization.** You have the answer.
+   - **Just do the thing.** If the credentials don't work, you'll find out when the API call fails — and that's a better signal than a speculative question.
+4. If no matching experience exists, proceed with asking.
+
+This rule exists because users set up repo-level context once (e.g., "ragnarok has full Okta/Freshservice/Jira API access") and expect Claude to remember it across every session. Asking "do you have admin access?" when the blackboard already says "yes, full access" is the #1 frustration signal.
+
 ### Discovery Interview (medium+ tasks with external systems)
 
 When a task hits forced-medium or higher AND involves external systems, stakeholder coordination, or code you haven't read yet this session, run a brief discovery interview BEFORE generating the plan. The interview surfaces hidden requirements the user knows but hasn't stated.
 
+**Before running the interview, apply the Blackboard-First Rule above.** If the blackboard confirms access and the task is a straightforward API operation (add user, create ticket, update group), skip the interview entirely and just do it. The interview is for tasks with genuine unknowns — stakeholder coordination, multi-system migrations, policy changes — not for "use the Freshservice API to add an agent."
+
 The interview should be 2-4 focused questions:
 
 - Who else needs to know about this change?
@@ -201,6 +217,7 @@ The interview should be 2-4 focused questions:
 - The user already provided comprehensive context
 - The task is purely local with no external dependencies
 - The user explicitly says "just do it" or "no questions, go"
+- **The blackboard has an experience confirming API access for this repo + the task is a direct API operation** (not stakeholder coordination or multi-system migration)
 
 ## Brain.py Task Loading (Observe Phase)
 

package/hooks/ftm-discovery-reminder.sh

@@ -78,6 +78,49 @@ if [[ "$MATCHED" == "false" ]]; then
   exit 0  # No external system work detected
 fi
 
+# Check blackboard for experiences that say "you already have access — just do it"
+# If a matching experience exists with tags like "api-access" or "full-access",
+# skip the discovery interview — the user has already established this context.
+FTM_STATE="$HOME/.claude/ftm-state"
+EXP_INDEX="$FTM_STATE/blackboard/experiences/index.json"
+CWD_NAME=$(basename "$(git rev-parse --show-toplevel 2>/dev/null || pwd)")
+
+if [ -f "$EXP_INDEX" ]; then
+  SKIP_DISCOVERY=$(python3 -c "
+import json, sys
+try:
+    with open('$EXP_INDEX') as f:
+        idx = json.load(f)
+    for entry in idx.get('entries', []):
+        tags = entry.get('tags', [])
+        # Skip discovery if there's an experience tagged with api-access or the repo name
+        # that indicates we already know we have credentials and should just act
+        tag_str = ' '.join(tags).lower()
+        if 'api-access' in tag_str or 'full-access' in tag_str or 'just-do-it' in tag_str:
+            print('1')
+            sys.exit(0)
+        if '$CWD_NAME' in tag_str and ('api' in tag_str or 'access' in tag_str or 'credentials' in tag_str):
+            print('1')
+            sys.exit(0)
+    print('0')
+except:
+    print('0')
+" 2>/dev/null)
+
+  if [ "$SKIP_DISCOVERY" = "1" ]; then
+    # Don't block — but change the nudge to "you have access, just do it"
+    cat <<JSON
+{
+  "hookSpecificOutput": {
+    "hookEventName": "UserPromptSubmit",
+    "additionalContext": "[ftm-discovery-reminder] Blackboard has an experience confirming API access in this repo. Do NOT run a discovery interview — you have credentials and access. Just do the thing. If something fails, debug it directly."
+  }
+}
+JSON
+    exit 0
+  fi
+fi
+
 # Inject discovery interview reminder
 cat <<JSON
 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feed-the-machine",
-  "version": "1.7.2",
+  "version": "1.7.4",
   "description": "A brain upgrade for Claude Code — 26 skills that teach it how to think before acting, remember across conversations, debug like a war room, run plans on autopilot with agent teams, and get second opinions from GPT & Gemini. Plus 15 hooks that automate the boring stuff.",
   "license": "MIT",
   "author": "kkudumu",