{"id":51668057,"url":"https://github.com/jinplu/teamwork","last_synced_at":"2026-07-14T22:00:48.747Z","repository":{"id":357654576,"uuid":"1237904058","full_name":"JinPLu/Teamwork","owner":"JinPLu","description":"Evidence-first skills for Codex, Cursor, and Claude Code: research, debugging, planning, execution, review, and goal loops.","archived":false,"fork":false,"pushed_at":"2026-07-10T17:29:38.000Z","size":5532,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-10T19:12:44.583Z","etag":null,"topics":["agent-skills","ai-agents","claude-code","codex","cursor","developer-tools","llm-workflow","multi-agent","prompt-engineering","research-workflow"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/JinPLu.png","metadata":{"files":{"readme":"README.en.md","changelog":"CHANGELOG.en.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-13T16:08:58.000Z","updated_at":"2026-07-10T17:29:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/JinPLu/Teamwork","commit_stats":null,"previous_names":["jinplu/teamwork"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/JinPLu/Teamwork","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JinPLu%2FTeamwork","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JinPLu%2FTeamwork/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JinPLu%2FTeamwork/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JinPLu%2FTeamwork/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JinPLu","download_url":"https://codeload.github.com/JinPLu/Teamwork/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JinPLu%2FTeamwork/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35480624,"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-07-14T02:00:06.603Z","response_time":114,"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-skills","ai-agents","claude-code","codex","cursor","developer-tools","llm-workflow","multi-agent","prompt-engineering","research-workflow"],"created_at":"2026-07-14T22:00:23.529Z","updated_at":"2026-07-14T22:00:48.724Z","avatar_url":"https://github.com/JinPLu.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Teamwork\n\n[中文](README.md) · [Changelog](CHANGELOG.en.md) · [Contributing](CONTRIBUTING.md) · [MIT License](LICENSE)\n\n**Help Codex, Cursor, and Claude Code gather evidence before acting and finish complex research or engineering work with checkable results.**\n\nTeamwork is a Codex-first skill package. After installation, describe your goal in natural language as usual. Teamwork organizes research, debugging, planning, execution, and review when the task needs them, while simple requests stay direct.\n\n![Teamwork workflow](assets/teamwork-workflow-gpt-image-2.png)\n\n## What You Get\n\n- **More reliable research:** Ground work in primary sources, project files, and real configuration instead of inventing paths, ports, models, or parameters.\n- **More focused questions:** Inspect discoverable facts first and ask you only about decisions that change the outcome, scope, acceptance, or authority.\n- **Controlled collaboration:** Use subagents only when work splits cleanly; the main agent keeps ownership of scope, integration, and final verification.\n- **Clear completion evidence:** Show whether the task is truly done with sources, logs, tests, diffs, or review results.\n- **Continuity for long tasks:** Keep the evidence needed across turns and resume from the affected work after a failure.\n\nTeamwork is a good fit for literature and field research, technical evaluation, complex plans, reproducible failures, CI, cross-file implementation, strict review, and “keep going until it passes” work. One-line facts and obvious small edits do not get forced into a workflow.\n\n## Quick Start\n\nYou need a working Codex, Cursor, or Claude Code installation. The repository installer runs through Bash.\n\nFor Codex:\n\n```bash\ngit clone https://github.com/JinPLu/Teamwork.git\ncd Teamwork\n./install.sh codex\n./scripts/check-update.sh --no-fetch\n```\n\nThen ask for the result directly—there are no skill names to memorize:\n\n```text\nResearch this field, its key papers, and the existing code, then propose an executable plan.\nFind the root cause of this CI failure; confirm it with logs and a reproduction before fixing it.\nExecute the accepted plan and verify it; keep iterating until it passes or reaches a real blocker.\nStrictly review this output for false success, defensive fallback, and AI bloat.\nGrill me: challenge only decisions that change the outcome, and stop when none remain.\n```\n\n## Install\n\n| Target | Command |\n|---|---|\n| Codex | `./install.sh codex` |\n| Cursor | `./install.sh cursor` |\n| Claude Code | `./install.sh claude` |\n| All platforms | `./install.sh all` |\n\nThese user-level commands make Teamwork skills and agents available to the current user; they do not modify every project automatically. To configure one repository, use the `project` or `init-project` target below with an explicit project path.\n\nThe default installation uses the `performance-first` profile. See every target and option with:\n\n```bash\n./install.sh --help\n```\n\nCommon options:\n\n```bash\n./install.sh --profile cost-first codex\n./install.sh --notifications codex\n./install.sh --project-root /path/to/project project\n./install.sh --project-root /path/to/project init-project\n```\n\n- `--profile cost-first`: prefer current lower-cost models.\n- `--notifications`: add main-turn completion and permission-request sounds to direct platform installs; subagents stay silent. Full `all`/`init-project` installs enable them by default; use `--no-notifications` to opt out. After a Codex install, run `/hooks` in the CLI and trust the two Teamwork hooks individually.\n- `project`: install only the project-level Teamwork skills and agents into the selected repository.\n- `init-project`: fully initialize one selected repository with project skills, agents, project rules, a Teamwork work-record entrypoint, and CodeGraph when available; it also installs user-level skills, agents, and default rules for the current user.\n\nRestart Codex after a user-level installation changes role routing. Cursor User Rules still require a manual copy-and-paste step that the installer cannot verify. The installer manages only Teamwork-owned directories, marked rules, and bounded configuration; it does not take over platform permissions, MCP, browser, or test settings. See the [Codex guide](CODEX.md), [Cursor guide](CURSOR.md), and [Claude Code guide](CLAUDE.md) for platform details.\n\n## Update\n\nAfter updating the repository, rerun the original install command and check the installed state:\n\n```bash\ngit pull --ff-only\n./install.sh codex\n./scripts/check-update.sh --no-fetch\n```\n\nTo include a project-local installation in the check:\n\n```bash\n./scripts/check-update.sh --project /path/to/project\n```\n\n## More Information\n\n- [Changelog](CHANGELOG.en.md): user-visible changes in each release.\n- [Codex guide](CODEX.md), [Cursor guide](CURSOR.md), and [Claude Code guide](CLAUDE.md): platform setup and advanced usage.\n- [Repository architecture](docs/architecture.md): canonical sources, generated directories, stable commands, and change owners.\n- [Contributing](CONTRIBUTING.md): change scope and verification requirements.\n- [GitHub Issues](https://github.com/JinPLu/Teamwork/issues): problems and suggestions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjinplu%2Fteamwork","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjinplu%2Fteamwork","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjinplu%2Fteamwork/lists"}