{"id":50652911,"url":"https://github.com/sssogin/malts","last_synced_at":"2026-06-07T22:01:03.885Z","repository":{"id":363186453,"uuid":"1262000552","full_name":"SssoGin/MALTS","owner":"SssoGin","description":"Multi-Agent Long-Task Scheduling and Growth System for AI coding agents, with file-based state, verification, handoff, and reusable learning.","archived":false,"fork":false,"pushed_at":"2026-06-07T20:27:02.000Z","size":134,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-07T21:14:49.634Z","etag":null,"topics":["agent-coordination","agent-memory","agent-orchestration","ai","ai-agents","ai-skills","claude-code","codex","coding-agents","developer-tools","long-running-tasks","multi-agent","opencode","workflow-automation"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SssoGin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-07T12:48:21.000Z","updated_at":"2026-06-07T20:24:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/SssoGin/MALTS","commit_stats":null,"previous_names":["sssogin/malts"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/SssoGin/MALTS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SssoGin%2FMALTS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SssoGin%2FMALTS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SssoGin%2FMALTS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SssoGin%2FMALTS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SssoGin","download_url":"https://codeload.github.com/SssoGin/MALTS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SssoGin%2FMALTS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34039495,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-07T02:00:07.652Z","response_time":124,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-coordination","agent-memory","agent-orchestration","ai","ai-agents","ai-skills","claude-code","codex","coding-agents","developer-tools","long-running-tasks","multi-agent","opencode","workflow-automation"],"created_at":"2026-06-07T22:00:38.422Z","updated_at":"2026-06-07T22:01:03.867Z","avatar_url":"https://github.com/SssoGin.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MALTS\n\n**Multi-Agent Long-Task Scheduling and Growth System**\n\nLanguages: [English](README.md) | [简体中文](README.zh-CN.md)\n\nA file-based workflow system that helps AI coding agents handle long-running tasks, coordinate agent collaboration, and turn reviewed experience into reusable rules.\n\nMALTS is a Multi-Agent Long-Task Scheduling and Growth System for AI coding agents. It records goals, plans, task ownership, verification, handoffs, and retrospectives in project files so long-running work stays recoverable, verifiable, collaborative, and able to convert reviewed lessons into reusable guidance.\n\nMALTS is relevant for migrations, multi-file changes, long bug investigations, release preparation, protocol/documentation updates, and other coding tasks where losing context or skipping verification would create avoidable risk.\n\nMALTS is a portable workflow system made of canonical skills, templates, checklists, adapters, scripts, and public maintenance docs.\n\nMALTS is single-agent first. That means that after MALTS is enabled, the main controller remains the default executor. Multi-agent work is a controlled division-of-work mechanism enabled only when needed, and every real sub-agent dispatch requires an explicit launch review first.\n\n## Start Here\n\n| Need | Read |\n|---|---|\n| Install MALTS and run a first task | [Getting Started](docs/GETTING_STARTED.md) |\n| Understand what MALTS does and when to use it | [System Overview](docs/SYSTEM_OVERVIEW.md) |\n| Review the full operating model and design boundaries | [Core Design](docs/CORE_DESIGN.md) |\n| Install a specific Agent tool adapter | [Install](docs/INSTALL.md) |\n| Configure Agent-assisted installation safely | [Agent Install](docs/AGENT_INSTALL.md) |\n\n## What Problem It Solves\n\nMALTS addresses operating risks that appear when coding-agent work becomes longer than a short, self-contained exchange. The main risks are goal drift, loss of recoverable state, weak completion evidence, unsafe multi-agent coordination, and uncontrolled growth of durable rules or memory.\n\nMALTS responds by externalizing important state into files, defining completion criteria, recording verification evidence, requiring explicit launch review before sub-agent dispatch, and filtering reusable lessons before promotion into durable guidance.\n\n## What It Provides\n\n- Long-task planning and recovery through `PROJECT_CONTROL.md`\n- Optional multi-agent launch review and role-based task dispatch\n- Verification checklists for delivery, memory writes, and quality gates\n- Agent-facing project handoffs through `PROJECT_HANDOFF.md`\n- Phase and final delivery reporting through `WORK_TASK_REPORT.md`\n- Growth review and durable candidate handling through the MALTS Memory Pipeline\n- Canonical `SKILL.md` packages under `skills/`, installed to each supported Agent tool's local skill directory\n- Optional bilingual documentation synchronization\n- Optional adapters for Codex, Claude Code, and OpenCode\n- Lightweight linting and project-control generation tools\n\n## Core And Optional Capabilities\n\n| Capability | Default | Purpose |\n|---|---|---|\n| Single-agent execution | On | Keep small and clear tasks low-overhead. |\n| `PROJECT_CONTROL.md` | Created when MALTS is enabled or recovery is needed | Preserve goal, queue, decisions, risks, ownership, and verification state. |\n| `WORK_TASK_REPORT.md` | Used after MALTS phases or final delivery | Report result, checks, risks, and next steps. |\n| `PROJECT_HANDOFF.md` | Used for continuation or context-risk handoff | Provide Agent-facing recovery context. |\n| Grill-Me Preflight | Offered for non-trivial or unclear starts | Expose assumptions, goal boundaries, tradeoffs, and acceptance criteria before implementation. |\n| Multi-agent scheduling | Off | Add controlled delegation only when exploration, verification, parallelism, or recovery value justifies it. |\n| Memory Pipeline | Available | Filter reusable lessons before promoting them into durable rules or memory. |\n| Bilingual documentation sync | Off | Maintain optional Chinese review mirrors when needed. |\n\n## Activation And Artifacts\n\nMALTS files are not created by default for every task. For small work, stay single-agent and use the normal project instructions.\n\nWhen MALTS is enabled or a task grows into recoverable long-task mode, create or reuse `PROJECT_CONTROL.md` in the project root. Each MALTS phase or final delivery should write or append `WORK_TASK_REPORT.md`. Use `PROJECT_HANDOFF.md` when a future Agent needs to continue from the recorded state.\n\n| File | Default Role |\n|---|---|\n| `PROJECT_CONTROL.md` | Agent-facing project state and task queue |\n| `WORK_TASK_REPORT.md` | User-facing phase/final report, usually in the user's or project's language |\n| `PROJECT_HANDOFF.md` | Agent-facing continuation and recovery source |\n\n## Repository Layout\n\n```text\nskills/                Canonical MALTS SKILL.md packages\nruntime/EN/templates/    Project control, task, report, and handoff templates\nruntime/EN/checklists/   Delivery, quality, and memory-write checks\nadapters/                Optional Codex, Claude Code, and OpenCode adapter files\ntools/                   Lightweight MALTS validation utilities\nscripts/                 Safe installation helper scripts\ndocs/                    Design, install, usage, handoff, security, and maintenance docs\n```\n\n## Documentation Map\n\n- [Getting Started](docs/GETTING_STARTED.md): practical installation and first-use path.\n- [System Overview](docs/SYSTEM_OVERVIEW.md): public explanation of goals, features, optional capabilities, and boundaries.\n- [Usage](docs/USAGE.md): concise operating guide for normal tasks, long tasks, multi-agent work, growth, and handoff.\n- [Core Design](docs/CORE_DESIGN.md): detailed system model, invariants, task sizing, and protocol boundaries.\n- [Install](docs/INSTALL.md): installation command reference.\n- [Agent Install](docs/AGENT_INSTALL.md): rules for Agent-assisted installation.\n- [Handoff](docs/HANDOFF.md): handoff file behavior and release boundary.\n- [Security](docs/SECURITY.md): release hygiene and secret-handling rules.\n- [Maintainer Guide](docs/MAINTAINER_GUIDE.md): public-safe maintenance, CI, versioning, and handoff boundaries.\n\n## Acknowledgements\n\nMALTS includes public-safe adaptations of agent behavior patterns inspired by:\n\n- [multica-ai/andrej-karpathy-skills](https://github.com/multica-ai/andrej-karpathy-skills), for concise coding-agent behavior guardrails.\n- [mattpocock/skills](https://github.com/mattpocock/skills), especially the idea of a pre-implementation grilling workflow.\n\nThese projects are not dependencies of MALTS and do not endorse this repository. See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).\n\n## Install Preview\n\nInstallation is intentionally review-first. The install script defaults to dry-run and does not write files unless `-Apply` is provided.\n\nTool instruction templates such as `AGENTS.md` and `CLAUDE.md` are optional MALTS enhancements. They help the Agent remember MALTS task mode, Grill-Me Preflight, project control, handoff, and verification rules, but they should be reviewed and merged with any existing user or project instructions instead of blindly replacing them.\n\n```powershell\n.\\scripts\\Install-MALTS.ps1 -Tool Codex\n.\\scripts\\Install-MALTS.ps1 -Tool Codex -Apply\n.\\scripts\\Install-MALTS.ps1 -Tool ClaudeCode -SkipInstructionTemplate\n```\n\nIf Windows PowerShell blocks script execution, run the same command with a process-local policy override:\n\n```powershell\npowershell -NoProfile -ExecutionPolicy Bypass -File .\\scripts\\Install-MALTS.ps1 -Tool Codex\n```\n\nSupported tools:\n\n```text\nCodex\nClaudeCode\nOpenCode\nAllIncluded\n```\n\nSee [docs/INSTALL.md](docs/INSTALL.md) and [docs/AGENT_INSTALL.md](docs/AGENT_INSTALL.md).\n\n## Documentation Language\n\nThe public repository defaults to English source documents. A Simplified Chinese public entry is available at [README.zh-CN.md](README.zh-CN.md), with translated public docs under `docs/zh-CN/`. English docs and root `skills/` remain the source of truth for Agent execution. See [docs/BILINGUAL_DOCS.md](docs/BILINGUAL_DOCS.md).\n\n## Version\n\nCurrent release version:\n\n```text\n0.1.2\n```\n\n## License\n\nMIT License. See [LICENSE](LICENSE).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsssogin%2Fmalts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsssogin%2Fmalts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsssogin%2Fmalts/lists"}