j-space-cognition-suite-v3.7

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

* HLE scores were not disclosed and follow DeepSeek V4-Flash-0731. The average covers the 7 rows where all 5 columns have values.

2. Speed and token efficiency

* For HLE (w/o tools) τ=1.02 is intentionally positive (i.e., slower): on single-turn tasks the Skill entry is a net overhead.

See: DeepSeek V4 × J-Space Capability Realization Report.

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
├── 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 does not become its own source of context pressure.

Maintainers can verify the package from its root:

<python-command> j-space/scripts/verify_suite.py
<python-command> -m unittest discover -s tests -v

Technical basis and scope

J-Space uses the operational workspace terminology established by Anthropic's related interpretability research. Within this suite, first-person language is treated as control grammar: accessible state descriptions are bound to explicit actions, checks, and settles.

The suite focuses on observable functional properties—reportability, deliberate maintenance, intermediate computation, broadcast, monitoring, and causal sensitivity. Detailed research interpretation, terminology, evidence boundaries, and sources are maintained in j-space/references/j-space-science.md.

Design principle:

Dense on the inside, decodable on demand, clean on the outside.

Use only the machinery the task earns.

Release history

J-Space has progressed through:

V1 → V1.5 → V1.8 → V2 → V2.5 → V2.6 → V3 → V3.1 → V3.2 → V3.5 → V3.5Turbo → V3.6 → V3.7

The V3.7 package contains one entry, nine focused modules, four supporting references, an optional runtime controller, an authoring-time verifier, standard-library regression tests, three-platform CI, Apache-2.0 licensing, and machine-readable citation metadata.

V3.7's problem-model routing incorporates the pull request opened by @lanting200, including commit contributions from @afeer123.

License

J-Space Cognition Suite is released under the Apache License 2.0. It permits use, modification, redistribution, and commercial integration under its notice and patent terms. See LICENSE for the complete terms. Quoted or summarized external source material remains subject to its source terms and is identified in THIRD_PARTY_NOTICES.md. When redistributing only the runtime j-space/ directory, carry both root files with it.