J-Space Cognition Suite V3.7

简体中文

J-Space Cognition Suite is a model-agnostic inference-time control system for deep reasoning, long-horizon work, tool use, verification, and recovery.

It is packaged as a Skill for cross-platform use, selective loading, and low-friction integration.

The suite organizes an agent's accessible working representations into a deliberately managed workspace. It operates through a single entry, nine selectively loaded modules, four supporting references, and an optional standard-library controller for durable task state.

J-Space operates at inference time. Model weights and training remain unchanged.

Quick start

Option A — manual installation

1. Download or clone this repository.

2. Locate the user-level Skills directory used by your AI host.

3. Copy the complete j-space/ directory into it so that the installed entry is <skills-directory>/j-space/SKILL.md.

4. Run the integrity check with an available Python 3 interpreter:

   <python-command> <skills-directory>/j-space/scripts/verify_suite.py
   

   Replace <python-command> with the Python 3 command available on the host, commonly python, python3, or py -3.

5. Reload the host if it discovers Skills at startup.

• The directory must remain intact because SKILL.md routes to relative paths under modules/, references/, and scripts/.

• The repository-level LICENSE and THIRD_PARTY_NOTICES.md remain part of the distribution.

• Include copies of both when redistributing j-space/ as a standalone package.

Option B — ask an AI agent to install it

Copy the following prompt into an agent that can access files and this repository:

Install J-Space Cognition Suite from
https://github.com/Tiger3807861189/J-Space-Cognition-Suite-V3.7 into this environment's user-level Skills directory.

First inspect the host configuration or documentation to locate the correct Skills directory. Install the complete j-space/ directory as j-space/, preserving SKILL.md, modules/, references/, and scripts/. If a j-space target already exists, compare it and ask before replacing anything. Run scripts/verify_suite.py with an available Python 3 interpreter after installation.

When finished, report the installed path and verification result, then tell me how this host invokes the Skill. Briefly explain fast, full, and loop, and explain that the optional controller records long-task state rather than choosing solutions. If this host has no native Skill loader, explain the selective system/developer-instruction integration instead of reporting an installation.

Use it

Invoke the Skill through the mechanism provided by your host—such as its Skill picker, /j-space, $j-space, or a direct request:

Use j-space for this task. Audit this repository, preserve its architecture, verify every finding, and keep the work consistent across all affected files.

The entry gate selects the lightest suitable pass automatically.

Operating modes

A request for brevity changes the outer response length while verification remains aligned with the task's floor. Short work stays light; long work receives durable state only when it needs it.

Core mechanisms

The mechanisms are selectively loaded. They are not a fixed checklist for every request.

Optional controller

j-space/scripts/jspace.py externalizes loop state into .jspace/ in the current task workspace. Invoke it by its resolved Skill path while keeping the task workspace as the current directory.

<python-command> <skill-root>/scripts/jspace.py note --goal "what done means" --next "first action"
<python-command> <skill-root>/scripts/jspace.py note --open "does the parser preserve state?" --settled-by "unit tests over all ledger sections and edge inputs"
<python-command> <skill-root>/scripts/jspace.py note --close 1 --check "the parser preserves state" --by "unit tests over all ledger sections and edge inputs"
<python-command> <skill-root>/scripts/jspace.py seam
<python-command> <skill-root>/scripts/jspace.py ship OUTPUT_FILE
<python-command> <skill-root>/scripts/jspace.py resume

The controller records and reports state. Solution choice remains with the model. It uses the Python standard library and writes working state only under the task's .jspace/ directory.

Generic model integration

An environment with a native Skill loader can install j-space/ directly. For a chat or API environment, provide j-space/SKILL.md as a system- or developer-level instruction and expose modules/ and references/ through file or retrieval tools.

Selected files should be retrieved on demand. Selective loading is part of the operating design.

Benchmark

1. Main table

* Terminal Bench 2.1 figures for Opus-5 and Fable 5.1 are independently measured by a third party; no official entries exist.

\† Estimated, based on limited controlled experiments.

2. Speed and token efficiency

Speed and token efficiency come from a GAIA controlled pair.

Cross-model compatibility

The operating effects have been reproduced across the DeepSeek, Qwen, GLM, GPT, and Claude model families. Effect size varies with base capability, context policy, tool harness, sampling configuration, and benchmark implementation.

The portable unit is the protocol: workspace loading, selective routing, state externalization, verification, and recovery. It is independent of a vendor-specific tokenizer or model API.

Project structure

J-Space-Cognition-Suite-V3.7/
├── .github/workflows/verify.yml    # three-platform integrity and regression checks
├── .gitignore                      # keeps .jspace/ working state out of the repo
├── CITATION.cff                    # machine-readable citation metadata
├── CONTRIBUTING.md                 # contribution and provenance requirements
├── LICENSE                         # Apache License 2.0
├── README.md                       # English engineering guide
├── README.zh-CN.md                 # Chinese engineering guide
├── THIRD_PARTY_NOTICES.md          # attribution and license boundaries for source material
├── tests/test_jspace.py            # standard-library controller regression tests
└── j-space/
    ├── SKILL.md                    # single entry, gate, routing, and invariants
    ├── modules/                    # nine selectively loaded protocols
    ├── references/                 # evidence, induction, problem modeling, and worked exemplars
    └── scripts/
        ├── jspace.py               # optional loop controller
        ├── workspace-ledger.md     # ledger template and contract
        └── verify_suite.py         # authoring-time integrity check

SKILL.md is the only registered entry. Modules and references are loaded on demand so the control system d