user-thoughts

name	user-thoughts
description	Persist user decisions and project constraints to mdbase across sessions. Trigger on /user-thoughts or /ustht, or when the user discusses architecture, tech stack, rules, UI/UX, or project memory.
license	MIT
source	https://github.com/JularDepick/user-thoughts.SKILL
source_repo	JularDepick/user-thoughts.SKILL
source_type	community
date_added	2026-05-31
author	JularDepick
tags	["userthoughts","documentation","project-management","mdbase"]
tools	["claude","cursor","gemini"]
risk	safe
allowed-tools	read write bash
metadata	{"author":"JularDepick","category":"productivity","supported_agents":"[claude, cursor, gemini]"}

user-thoughts.SKILL

Overview

Across sessions and across agents, project decisions and user constraints are easy to lose. user-thoughts persists those decisions into a project-local mdbase so any future agent can recover the user's intent without re-deriving it from scratch.

The skill records user intent. It does not replace normal task execution. If the user says, "make the button red," the agent should both make the change and record the preference when persistent project memory is useful.

When to Use

Use this skill when the user states or revises:

• Project rules, constraints, preferences, or requirements.
• Architecture, tech-stack, data-model, deployment, or workflow decisions.
• UI/UX direction, copy standards, visual preferences, or design rationale.
• Backlog items, planned work, rejected options, or decisions that future agents should inherit.
• A direct command beginning with /user-thoughts or /ustht.

Do not use it for unrelated small talk, transient chatter, or content the user explicitly asks to ignore.

Language Policy

• All bundled skill files, scripts, templates, and reference docs are written in English.
• Agent-facing command output should follow the user's current conversation language when the agent can reasonably do so.
• Raw user thoughts should preserve the user's original wording. Do not translate, summarize, or clean the user's intent unless the user asks for that.

Core Workflow

User message -> Agent identifies persistent project intent -> write to #raw/
             -> /ustht sortin groups raw entries into #mdbase/
             -> /ustht mdbase show exposes the organized memory base

Runtime Modes

• Passive mode: INSTANT_STATUS=off; only explicit skill commands run.
• Instant mode: INSTANT_STATUS=on and SKILL_STATUS=on; project-relevant user thoughts are written to #raw/ as they appear.
• Ignore mode: ignore start and ignore end mark a temporary interval that should not be recorded.
• Read-only mode: if required read/write/bash tools are unavailable, show commands can still work but write commands should explain that the enprojectnment cannot persist data.

SKILL_STATUS=off pauses instant capture even when INSTANT_STATUS=on. Ignore intervals are context-local and do not persist across sessions.