Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
71 changes: 44 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -578,41 +578,58 @@ separates shipped foundations from the next end-to-end acceptance milestones.

</details>

## Contributing
<a id="contributing"></a>
<a id="community--feedback"></a>

Help make long-horizon Agent work easier to run, inspect and trust.
Contributions can start with a host integration, a reproducible bug, a
documented workflow or a carefully bounded evidence study.
## Community & Contributing

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P2] Preserve the previous generated community permalink

Renaming the old Community and Feedback heading removes GitHub’s #community-and-feedback target. The retained community--feedback anchor is a different legacy URL. On the immutable base the old permalink scrolls to the community section; on this head the target is absent and the page stays at the top. Add <a id="community-and-feedback"></a> beside the existing aliases and verify both old fragments on the rendered README. This is a post-merge follow-up repair.


Help shape how long-horizon Agent teams work. Share a workflow, reproduce a
bug, build an integration, or show what your Agents accomplished. Code,
documentation, examples, reviews and carefully bounded evidence studies are
all welcome.

- **Learn:** [Documentation](https://loopx-project.github.io/loopx/docs/) ·
[Blog](https://loopx-project.github.io/loopx/blog/) ·
[Technical directions](docs/project/technical-directions.md).
- **Discuss and share:** ask questions, compare workflows and share projects in
[GitHub Discussions](https://github.com/loopx-project/loopx/discussions).
- **Report a bug or suggest a feature:** open a
[GitHub Issue](https://github.com/loopx-project/loopx/issues/new/choose) with
your version, host/runtime, expected behavior and a public-safe reproduction.
- **Make your first contribution:** pick a public task from
[Contributor Tasks](docs/development/contributor-tasks.md), or bring a
self-contained fix. The [contribution guide](CONTRIBUTING.md) covers setup,
validation and the PR process; larger changes start with a discussion.
- **Join the conversation:** [Discord](https://discord.gg/XmGgQyCFZd) ·
[Lark](docs/assets/loopx-lark-developer-group.png) ·
[WeChat](docs/assets/loopx-wechat-contact.png).

See [Support](.github/SUPPORT.md) for channel routing and official sources, and
our [Code of Conduct](CODE_OF_CONDUCT.md) for community participation.

External contributors should start with
[Contributor Tasks](docs/development/contributor-tasks.md) for public, claimable work and
[Contributing](CONTRIBUTING.md) for setup, validation, and boundary rules.
Project roles and public history are recorded in
[Governance](.github/GOVERNANCE.md),
[Authors and Contributors](docs/project/authors.md), and
[Project History](docs/project/history.md).
<details>
<summary>Before sharing code, logs or examples</summary>

LoopX keeps local active state separate from the public repository. Do not
commit `.loopx/`, legacy `.codex/goals/`, live `ACTIVE_GOAL_STATE.md`, raw benchmark
traces, credentials, private logs, or operator artifacts.
Keep `.loopx/`, legacy `.codex/goals/`, live `ACTIVE_GOAL_STATE.md`, raw Agent
sessions and benchmark traces, credentials, private logs, internal links,
sensitive user/team data and operator artifacts out of public contributions.

<a id="community--feedback"></a>
</details>

### Contributors

## Community and Feedback
Thank you to everyone contributing code, documentation, bug reports, reviews
and real-world feedback. You help make long-horizon Agent work easier to run,
inspect and trust.

LoopX is already running real long-running agent goals and is under active
development. The most useful feedback comes from real long-running agent
projects: where the control plane helped, where it felt heavy, and which gates
or handoffs disappeared from view.
[![LoopX GitHub contributors](https://contrib.rocks/image?repo=loopx-project/loopx&columns=12&max=120)](https://github.com/loopx-project/loopx/graphs/contributors)

- Use [GitHub Issues](https://github.com/loopx-project/loopx/issues) for
reproducible bugs, install problems, and feature requests.
- Open PRs for docs fixes, showcase writeups, and small public-safe examples.
- Join the [Discord community](https://discord.gg/XmGgQyCFZd), or use Lark or
WeChat below.
[All GitHub contributors](https://github.com/loopx-project/loopx/graphs/contributors) ·
[Authors and contribution records](docs/project/authors.md) ·
[Governance](.github/GOVERNANCE.md) · [Project history](docs/project/history.md) ·
[Name and marks](docs/project/trademarks.md).

See [Support](.github/SUPPORT.md) for channel routing, service boundaries, and
official publication sources.
### Community chats

<p align="center">
<a href="docs/assets/loopx-lark-developer-group.png"><img src="docs/assets/loopx-lark-developer-group.png" alt="LoopX Lark developer group QR code" width="280"></a>
Expand Down
63 changes: 40 additions & 23 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -516,37 +516,54 @@ provider 的打包和生命周期,不是另一个控制面 owner。详见

</details>

## 贡献
<a id="贡献"></a>
<a id="用户群与反馈"></a>

## 社区与贡献

一起探索长程 Agent 团队的工作方式。分享你的工作流、复现一个问题、接入新的宿主,
或展示 Agent 做出的成果。代码、文档、示例、评审和边界清楚的证据研究,都欢迎参与。

- **了解项目:**[使用文档](https://loopx-project.github.io/loopx/docs/) ·
[技术博客](https://loopx-project.github.io/loopx/blog/zh/) ·
[技术方向](docs/project/technical-directions.md)。
- **提问与分享:** 在 [GitHub Discussions](https://github.com/loopx-project/loopx/discussions)
交流使用问题、比较工作流、展示你的项目。
- **报告问题或建议功能:** 提交
[GitHub Issue](https://github.com/loopx-project/loopx/issues/new/choose),说明版本、
宿主/运行时、预期行为,并附上可公开的复现步骤。
- **开始第一次贡献:** 从 [Contributor Tasks](docs/development/contributor-tasks.md)
选择公开任务,也可以直接提交独立完整的修复。
[贡献指南](CONTRIBUTING.md)介绍环境搭建、验证与 PR 流程;较大改动请先讨论。
- **加入交流:**[Discord](https://discord.gg/XmGgQyCFZd) ·
[飞书开发群](docs/assets/loopx-lark-developer-group.png) ·
[微信](docs/assets/loopx-wechat-contact.png)。

渠道分工、支持边界和官方发布源见 [Support](.github/SUPPORT.md),
社区参与约定见[行为准则](CODE_OF_CONDUCT.md)。

一起让长程 Agent 工作更容易运行、检查和信任。可以从宿主集成、可复现问题、
工作流文档或边界清楚的证据研究开始。
<details>
<summary>分享代码、日志或示例之前</summary>

公开、可认领的任务见 [Contributor Tasks](docs/development/contributor-tasks.md)。贡献前请读
[Contributing](CONTRIBUTING.md),尤其是 public/private 边界、smoke 保留规则和
benchmark 证据边界。
不要提交 `.loopx/`、`.codex/goals/`、live `ACTIVE_GOAL_STATE.md`、内部链接、
原始 Agent 会话、raw benchmark task/log/trajectory/verifier output、credentials、
token、私有日志、私有路径、操作员产物或未脱敏的用户与团队信息。

项目角色与维护权限见 [Governance](.github/GOVERNANCE.md),创建者与贡献者归属见
[Authors and Contributors](docs/project/authors.md),关键公开演进见
[Project History](docs/project/history.md),名称与标识使用见
[Name and Marks](docs/project/trademarks.md)。
</details>

不要提交 `.loopx/`、`.codex/goals/`、live `ACTIVE_GOAL_STATE.md`、内部链接、
raw benchmark task/log/trajectory/verifier output、credentials、token、私有路径或
未脱敏的用户与团队信息。
### 贡献者

## 用户群与反馈
感谢每一位贡献代码、文档、问题报告、评审和真实使用反馈的朋友。
你们让长程 Agent 工作更容易运行、检查和信任。

LoopX 已在真实长程 agent 目标上持续运行,并处于活跃迭代期。最需要真实长程
agent 项目里的反馈:控制面帮到了哪里、哪里太重,哪些 gate、handoff 或 scope
仍然不够清楚。
[![LoopX GitHub 贡献者](https://contrib.rocks/image?repo=loopx-project/loopx&columns=12&max=120)](https://github.com/loopx-project/loopx/graphs/contributors)

- 可复现 bug、安装问题、功能建议:请提
[GitHub Issue](https://github.com/loopx-project/loopx/issues)。
- 文档修正、showcase 补充、小型 public-safe 示例:欢迎开 PR。
- 参与社区讨论:可加入 [Discord 社区](https://discord.gg/XmGgQyCFZd),也可在
下方直接加入飞书群或通过微信申请入群。
[全部 GitHub 贡献者](https://github.com/loopx-project/loopx/graphs/contributors) ·
[创建者与贡献记录](docs/project/authors.md) ·
[项目治理](.github/GOVERNANCE.md) · [项目历史](docs/project/history.md) ·
[名称与标识](docs/project/trademarks.md)。

渠道分工、支持边界和官方发布源见 [Support](.github/SUPPORT.md)。
### 社区群聊

<p align="center">
<a href="docs/assets/loopx-lark-developer-group.png"><img src="docs/assets/loopx-lark-developer-group.png" alt="LoopX 飞书开发群二维码" width="280"></a>
Expand Down
Loading