Skip to content

bayuewalker/walkermind-os

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2,928 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WalkerMind OS

Intelligent by design. Autonomous by nature.

Powered by W.A.R.P Engine — Walker Autonomous Routing Protocol


Status Execution Python Private Engine Governance


Overview

WalkerMind OS is a multi-agent autonomous trading infrastructure powered by the W.A.R.P Engine — a structured execution protocol for building, validating, and operating algorithmic systems across prediction markets and financial platforms.

The system operates under a strict authority chain. WARP🔹CMD orchestrates. WARP🔸CORE executes. WARP•R00T hardens on owner assignment. Repo-truth governance and safety gates are enforced at every tier.

Active project: projects/polymarket/crusaderbot — CrusaderBot on Polymarket.

Polymarket · Kalshi · TradingView · MT4/MT5


Operating Posture

Execution is two-layer:

Platform layer (owner-gated). ENABLE_LIVE_TRADING is the system master switch — owner-controlled, never agent-flipped. LIVE is the end goal; development work proves out in PAPER first. The switch flips only when the Platform Release Gate conditions are all satisfied (see AGENTS.md → PLATFORM RELEASE GATE and {PROJECT_ROOT}/state/ROADMAP.md → Phase 9).

User layer. Once the platform is live-capable, each user chooses PAPER or LIVE for their own account. PAPER is an optional verification tool — recommended, not forced — to confirm a strategy obeys its rule conditions and money-management settings. User choice sits above the guard; it never bypasses it.

Current operational status (mode, gate progress, live-readiness) is tracked in {PROJECT_ROOT}/state/PROJECT_STATE.md and {PROJECT_ROOT}/state/ROADMAP.md, not in this README — state files are the source of truth.


System Architecture

WalkerMind OS
│
├── WARP•R00T           Hardening authority — owner-assigned; audit + fix + harden + self-merge
│
├── WARP🔹CMD           Director — reads repo truth, routes tasks, gates merges
└── WARP🔸CORE          Execution Team
    ├── WARP•FORGE       Build — implements, patches, refactors, opens PRs
    ├── WARP•SENTINEL    Review — audits MAJOR (capital-touch) changes before merge
    └── WARP•ECHO        Report — produces HTML reports and communication artifacts

Authority Chain

Mr. Walker  →  WARP•R00T (on owner assignment)  →  WARP🔹CMD  →  WARP🔸CORE (WARP•FORGE / WARP•SENTINEL / WARP•ECHO)

WARP•R00T runs only on explicit owner assignment for system-wide hardening. When active, WARP🔹CMD supports it; otherwise WARP🔹CMD is the top orchestration authority under Mr. Walker.

Agent Role
Mr. Walker Owner. Final authority on scope, risk, and capital decisions.
WARP•R00T Hardening authority. Owner-assigned. Audits, fixes, builds, hardens, and self-merges under full-bypass authority (inviolable invariants excepted).
WARP🔹CMD Director and gatekeeper. Reads repo truth, routes tasks, reviews and merges PRs.
WARP•FORGE Builder. Implements, patches, refactors, opens PRs. Never merges.
WARP•SENTINEL Validator. Audits MAJOR (capital-touch) changes before merge. Never merges.
WARP•ECHO Reporter. Produces HTML reports and communication artifacts from validated data. Never merges.

Repo Structure

walkermind-os/
├── AGENTS.md                           ← highest authority — global rules (v3.0)
├── PROJECT_REGISTRY.md                 ← active project registry
├── CLAUDE.md                           ← Claude Code agent rules (v3.0)
├── COMMANDER.md                        ← WARP🔹CMD operating reference (v3.0)
├── WARP_R00T.md                        ← WARP•R00T operating preset (v3.0)
├── MEMORY.md                           ← persistent operating memory
├── POLYMARKET_REFERENCE.md             ← Polymarket API & on-chain reference
├── docs/
│   ├── KNOWLEDGE_BASE.md               ← architecture, infra, API reference
│   ├── workflow_and_execution_model.md ← W.A.R.P operational protocol
│   ├── blueprint/                      ← target architecture guidance
│   └── templates/                      ← state, roadmap, and report templates
├── lib/                                ← shared libraries across projects
└── projects/
    ├── polymarket/
    │   └── crusaderbot/               ← PROJECT_ROOT (active)
    │       ├── state/
    │       │   ├── PROJECT_STATE.md    ← operational truth
    │       │   ├── ROADMAP.md          ← milestone truth + go-live arm sequence
    │       │   ├── WORKTODO.md         ← task tracking
    │       │   └── CHANGELOG.md        ← lane closure history
    │       ├── core/ · data/ · strategy/ · intelligence/
    │       ├── risk/ · execution/ · monitoring/
    │       ├── api/ · infra/ · backtest/
    │       └── reports/
    │           ├── forge/              ← WARP•FORGE build reports
    │           ├── sentinel/           ← WARP•SENTINEL validation reports
    │           ├── briefer/            ← WARP•ECHO communication artifacts
    │           └── archive/            ← reports older than 7 days
    ├── tradingview/
    │   ├── indicators/
    │   └── strategies/
    └── mt5/
        ├── ea/
        └── indicators/

Source of Truth — Priority Order

# File Role
1 AGENTS.md Highest authority — overrides everything
2 PROJECT_REGISTRY.md Active project navigation
3 {PROJECT_ROOT}/state/PROJECT_STATE.md Current operational state
4 {PROJECT_ROOT}/state/ROADMAP.md Phase and milestone truth
5 {PROJECT_ROOT}/state/WORKTODO.md Granular task tracking
6 reports/forge/, reports/sentinel/ Build and validation evidence

Operating references (COMMANDER.md, CLAUDE.md, WARP_R00T.md) and MEMORY.md sit below the rule files; on any conflict AGENTS.md wins, and code truth wins over report wording. The four governance files (AGENTS / CLAUDE / COMMANDER / WARP_R00T) share one version — a mismatch is drift.


Validation Tiers

Tier is decided by the Capital-Touch Test (AGENTS.md), not by keyword.

Tier Scope Gate
MINOR Wording, docs, templates, non-runtime cleanup WARP🔹CMD review (no report)
STANDARD Runtime behavior that does not touch the capital path WARP🔹CMD review
MAJOR Touches the capital path — order placement/cancel/modify, sizing/Kelly/allocation, a risk control, balance/ledger truth, the live-trading guard, or the RISK→EXECUTION async path WARP•SENTINEL required before merge

WARP•R00T may self-merge any tier on owner assignment, except the inviolable invariants below.


Branch Naming

WARP/{feature}            ← FORGE / SENTINEL / ECHO lanes   (warp/{feature} also valid)
WARP/root-{feature}       ← WARP•R00T lanes                 (warp/root-{feature} also valid)

Short hyphen-separated slug. No dots, underscores, or date suffixes. Auto-generated claude/* branches are forbidden — every branch must be pre-declared.

WARP/wallet-state-read-boundary       ✓
WARP/root-paper-default-hardening     ✓
WARP/ROOT/paper-default-hardening     ✗  (double-slash — use WARP/root-...)
WARP/implement_wallet_state           ✗  (underscores)
WARP/phase6.5.3-fix-2026-04-16        ✗  (dots, date)
claude/happy-tesla-30Qei              ✗  (auto-generated)

Risk Model

Kelly-centered, and controls — not frozen values. The risk controls must exist, be wired into the RISK → EXECUTION path, and be testable. Their numeric thresholds are owner / per-user build-config, not constants baked into the repo.

Control Must be…
Position sizing (Kelly) Present and enforced in code — fractional Kelly only
Position cap Wired and testable
Drawdown halt Wired and testable
Daily-loss limit Wired and testable
Max concurrent trades Wired and testable (per-user configurable)
Liquidity floor Wired and testable
Arbitrage edge gate Wired and testable
Signal deduplication Mandatory
Kill switch Mandatory and testable

One frozen invariant: full Kelly (α = 1.0) is forbidden — fractional only. A risk violation is a control that is missing, unwired, or neutered to a no-op — not a value change. Authoritative definition: AGENTS.md → RISK MODEL.


W.A.R.P Operating Mode

Single low-friction mode (no normal/degen toggle). Optimize for throughput with safety intact: ship fast, function safe, small noise skipped — block only on real risk to capital / execution / runtime integrity, a critical safety finding, or a claim contradicted by code. Friction must justify itself.


Key References

Document Purpose
AGENTS.md Master rules — read before every task
COMMANDER.md WARP🔹CMD operating reference
WARP_R00T.md WARP•R00T hardening preset
POLYMARKET_REFERENCE.md Polymarket API & on-chain reference
docs/workflow_and_execution_model.md Full W.A.R.P operational protocol
docs/KNOWLEDGE_BASE.md Architecture, infra, API, and conventions
PROJECT_REGISTRY.md Active project list

WalkerMind OS · Powered by W.A.R.P Engine

Walker Autonomous Routing Protocol · Bayue Walker · Private Repository

About

WalkerMind OS — Autonomous Multi-Agent Infrastructure · Powered by W.A.R.P Engine

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors