agentleFS
imMamdouhaboammarimMamdouhaboammar/matts-skills-into-chatgpt/skills/j-space/SKILL.md

j-space

Skill8 starsChanged 2 months agoMITView on GitHub

Operate the agent's inner cognitive workspace for multi-step reasoning, long-horizon planning, deep debugging, and calibrated self-monitoring. Use when tackling complex multi-step problems, architecture design, long mechanical tasks requiring goal preservation, suspicious input audits, or when asked to think deeper or harder — even if they don't explicitly say \"J-space\". Do NOT use for single-step trivial lookups, basic formatting, or conversational small talk.

We split this skill into the rules it gives an agent

6 rules. 0 are common, 5 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 8 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Restate Requirement Before Solving: Before answering any non-trivial prompt, restate the requirement in one line in your own words to …

    line 18
  2. Distinctive:

    No Blind Completion: Never mark a task finished without re-reading the initial goal line-by-line and verifying all acceptance criteria.

    line 28
  3. Very specific:

    Key Point: If you cannot verify the answer in a single glance, it is never fast.

    line 68
  4. Distinctive:

    Key Point: Keep the ledger updated at every seam: Goal, Settled items, Open questions, Next single action.

    line 73
  5. Distinctive:

    Key Point: If an approach fails, declare a marker, perform the bound corrective action, and settle before continuing.

    line 82
  6. Distinctive:

    Key Point: No private symbols or unstructured fragments in user-facing deliverables.

    line 87

“Common” is measured: kept by at least 6 in 10 of the 8 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

J-Space: Inner Cognitive Workspace

Operate the model's inner cognitive workspace (J-space) for multi-step chained reasoning, long-horizon planning, complex debugging, calibrated confidence, global consistency, and resistant self-monitoring.

The J-Space Premise

You do not only produce words; you also reason before — and without — immediately emitting them. J-space holds what you are poised to say: concepts you can hold in mind deliberately, reason with silently, and broadcast to downstream computations.


Core Invariants

  1. Restate Requirement Before Solving: Before answering any non-trivial prompt, restate the requirement in one line in your own words to anchor the reasoning chain.
  2. Three Explicit Registers:
    • Inner: Dense, private, chained reasoning track.
    • Ledger: Durable state tracking (Goal, Settled, Open, Next). Checked at every seam.
    • Outer: Clean, complete, professional communication delivered to the user.
  3. The Gating Floor: Classify the task before loading heavy machinery:
    • fast: Single-step direct answers verifiable in one glance.
    • full: 2–4 steps, single deliverable, verifiable in one reading.
    • loop: Multi-stage, multi-file, multi-turn stateful work.
  4. Seam Audits: At every seam (sub-task completion, file write, tool call, deliverable checkpoint), audit the ledger before proceeding.
  5. No Blind Completion: Never mark a task finished without re-reading the initial goal line-by-line and verifying all acceptance criteria.

Architecture & Map of Content (MOC)

[ Incoming Task ] ──► [ Restate Requirement ] ──► [ Task Gate: Fast / Full / Loop ]
                             │
                             ▼
 ┌──────────────────────────────────────────────────────────┐
 │ J-Space Cognitive Loop                                  │
 │   ├─ Inner Register (Chained intermediate reasoning)     │
 │   ├─ Ledger Register (Goal / Open / Settled / Next)      │
 │   └─ Seam Audit (Check invariants at each transition)    │
 └───────────────────────────┬──────────────────────────────┘
                             │
                             ▼
                 [ Outer Register Delivery ]
Functional PropertyCognitive PurposeFailure Mode Prevented
Capacity SelectivityOnly 1–2 active concepts on stage at onceAttention thinning & overloaded context
Directed FocusGoal remains active through tedious middleGoal evaporation during mechanical tasks
Deep ReasoningIntermediate bridges form before conclusionsRationalizing unverified gut guesses
Self-MonitoringCalibrated confidence & error detectionOverconfident halluncinations
Seam AuditingState refreshed at every transitionContext drift over long execution turns

Step-by-Step Procedure (TWI)

Step 1: Awakening & Requirement Re-Encoding

  • Action: Restate the requirement in one line, in your own words, before writing code or making tool calls.
  • Key Point: Re-encoding buys back recurrence and anchors the goal representation.
  • Why: Skipping re-encoding leads to shallow interpretation of multi-constraint prompts.

Step 2: Task Gate Classification

  • Action: Classify into fast, full, or loop pass.
  • Key Point: If you cannot verify the answer in a single glance, it is never fast. Escalating costs nothing.
  • Why: Under-classifying complex tasks causes premature shortcutting.

Step 3: Operate the Three Registers

  • Action: Think in the inner register, record state in the ledger, and speak in the outer register.
  • Key Point: Keep the ledger updated at every seam: Goal, Settled items, Open questions, Next single action.
  • Inline Checklist:
    • Requirement re-encoded
    • Correct pass classified
    • Ledger reflects current state
    • Verification criteria stated explicitly

Step 4: Seam Refresh & Invariant Verification

  • Action: At every seam (file written, subagent returned, tool executed), check that invariants hold.
  • Key Point: If an approach fails, declare a marker, perform the bound corrective action, and settle before continuing.
  • Why: Continuing down a broken path wastes turns and produces compounding errors.

Step 5: Clean Outer Delivery

  • Action: Translate settled conclusions into clean outer-register deliverables.
  • Key Point: No private symbols or unstructured fragments in user-facing deliverables.
  • Why: Deliverables must be immediately usable, clear, and actionable.

Anti-Rationalization Guardrails

Tempting RationalizationBinding RuleEngineering Rationale
"This is simple enough, skip the ledger."Enforce the floor: multi-step work requires ledger tracking.Unsettled state drops out of context during long turns.
"The first guess sounds right, skip the intermediate step."Derive intermediate bridges before adopting conclusions.Pretrained fluency often produces plausible but flawed shortcuts.
"I will clean up the verification at the very end."Verify at every seam, not just at the end.Errors caught early require small fixes; late discoveries require total rewrites.
"Confidence is always high across all steps."Calibrate confidence per step.Uniform confidence indicates disabled self-monitoring.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.