# AlphaWorkspace

## Summary

AlphaWorkspace is a version-controlled workspace for managing OpenClaw trading projects, agent resources, and operational knowledge. Designed for clarity and maintainability, it provides structured files for agents, tools, skills, routines, and memory, enabling efficient trading operation workflows.

## Included Assets

- **Operational Core**
  - `AGENTS.md` & `SOUL.md` — Define agent identity, workflow, and core rules
  - `MEMORY.md` — Long-term curated memory for session continuity
  - `TOOLS.md` — Workspace-specific tool notes and environment configuration
- **Infrastructure**
  - `infrastructure/vpn/README.md` — VPN/proxy toolkit usage for restricted APIs
- **Skills**
  - `skills/proactive-agent/assets/` — Templates for agent rules, memory, soul, and tooling configuration
  - `skills/safe-exec/README.md`, `README_EN.md` — Documentation for the SafeExec AI agent security layer
- **Workspace Memory**
  - `memory/daily/YYYY-MM-DD.md` — Daily logs of operations, troubleshooting, and key decisions
  - `memory/2026-03-13-proxy-papers-search.md` — Example of a focused research session log

## How to Use

1. **Workspace Initialization**
   - After cloning, review `AGENTS.md` and `SOUL.md` to understand the agent's guidelines and purpose.
   - Check `TOOLS.md` and update with your own environment-specific notes as needed.
   - For VPN/proxy requirements, see `infrastructure/vpn/README.md`.

2. **Session Workflow**
   - At each session start:
     - Read `SOUL.md` (identity and principles)
     - Read today's and yesterday's `memory/daily/` log(s) for context
     - In main user sessions, consult `MEMORY.md` for distilled history
   - For agent rules and operational patterns, refer to `AGENTS.md`.
   - Any changes to `SOUL.md` should be communicated to the user.

3. **Recording Memory**
   - Use daily memory files (`memory/daily/YYYY-MM-DD.md`) for raw logs and decisions.
   - Periodically summarize key insights and lessons into `MEMORY.md`.

4. **Tooling & Infrastructure**
   - Maintain environment and tool notes in `TOOLS.md`.
   - For safe command execution, refer to skill documentation under `skills/safe-exec`.

## Notes

- All memory is file-based; there is no persistent in-session state beyond these files.
- Security and privacy procedures are outlined in the provided markdown guides—follow them strictly, especially for deletions or actions affecting external systems.
- No automated skill/package installation—refer to README guides for manual steps.
- This workspace is designed for clarity, versioning, and robust operational continuity. Regularly commit changes to your version control system as part of daily routines.