Skip to main content
The Agent Learning Loop is a shared learning mechanism provided by Comet for Personal Memory and Project Knowledge. It organizes user feedback, task results and project evidence into reusable contexts and provides them to the Agent as needed in subsequent tasks. This mechanism addresses two types of cross-task continuity problems:
  • ** Personal Memory ** retains your language, expression and collaboration preferences;
  • ** Project Knowledge ** Retain the project structure, design basis, modification relationships and verified engineering experience.
The Agent Learning Loop is the underlying mechanism of two types of plugins. You can use it through your Personal Memory and Project Knowledge without installing a third learning plugin.

Core value

The goal of Comet is to provide Agents with a better starting point for tasks. The current code, configuration, test and Runtime status still serve as the direct basis for task execution.

The trade-off between industry practice and Comet

Mainstream Coding agents typically supplement cross-session contexts from three directions: Claude Code distinguishes manually maintained CLAUDE.md from automatically formed memories; GitHub Copilot Memory distinguishes repository facts from user preferences; Cursor Rules loads control instructions through paths and correlations; Qoder Knowledge Engine organizes project understanding into an agent-oriented knowledge layer Comet continues these hierarchical principles and incorporates five governance pieces of information into the same chain: ** Owner, source, scope of application, source status, and application results **. This enables long-term context to be viewed, corrected and tracked, and also facilitates the location of why a piece of content enters the current task.

Responsibility stratification in the long-term context

Project Knowledge helps agents understand the project, rules provide team instructions, hooks and engineering checks are responsible for executing the boundaries of determinable judgments.

Key concept

From experience to task context

1. Record experiences with a clear scope

Classic, Native, Hotfix and Tweak hand over structured events to the same learning channel. Effective signals include:
  • The user explicitly requests to remember, correct or forget.
  • The actual result after the task is completed;
  • Verification of success or failure;
  • Processed Review conclusions;
  • Faults that have completed root cause confirmation, repair and re-inspection;
  • Change the final decision after archiving;
  • The result after a certain context is applied.
Experience only retains context, action summaries, results, and evidence references. Complete conversations, complete diffs, original logs, tool outputs, and hidden reasoning do not enter the long-term record.

2. Extract reusable conclusions

Clear long-term requirements follow a definite path. For instance, if you propose “I will answer in Chinese by default from now on”, your Personal Memory can take effect immediately. Experiences that require semantic induction are processed in the background by Reflection. For instance, after the Review confirms that a certain type of modification must be updated synchronously in the registry, the system will check whether the conclusion has been accepted, whether the modification has been completed, and whether the verification has been successful, and then decide whether to form a project strategy. Consolidation is responsible for consolidating synonyms, supplementing new evidence, tightening the scope of application, and removing invalid records from subsequent tasks.

3. Match the current task

The Context Director screens candidates based on the current project, path, task, operation and stage. The key portraits and a few verified strategies can be fully provided, and other relevant contents enter the Context Manifest. Each Manifest item contains a stable ID, title, source type, and whyApplied. whyApplied indicates the specific conditions under which this content hits the current task. When the Agent requires the complete text, source or verification method, it will be expanded according to the stable ID.

4. Continuously calibrate with the application results

After the content enters the task, Comet records the following results: The application results will affect subsequent sorting, status promotion, content rewriting or substitution. Comet pays attention to both matching relevance and actual task performance simultaneously.

Evidence and life cycle

Automatically generated content needs to be verified and reused to gain higher authority. Comet retains the following states for records: The forget operation uses an independent tombstone (forget marker). When the system replays historical events, it will recognize this tag to prevent forgotten content from re-taking effect.

Failure isolation

Explicitly add, correct, forget and expand the operations that the user is waiting for. When an operation fails, Comet returns an actual error and maintains the original state. When the background collection, Reflection, retrieval or a certain Learner fails, Comet records the diagnosis and continues the current workflow. Personal Memory and Project Knowledge use separate Providers, storage, and scopes. A single plugin failure will not interrupt another type of long-term context.

Product boundary

The Agent Learning Loop forms an external context that is visible, correctable and traceable. It does not train or fine-tune the model and adheres to the following boundaries
  • Not saving the complete chat, complete task trajectory or hiding reasoning;
  • Do not automatically publish personal project habits as team knowledge;
  • Do not cover AGENTS.md, Rule, Skill or project configuration;
  • Do not automatically generate linter, test, build or CI configurations for unknown technology stacks;
  • Do not expand the operation permissions such as submission, push, deletion and publication.

Follow-up Reading

  • Personal Memory: Keep Collaboration Preferences in effect ](/en/plugins/personal-memory)
  • Personal Memory principle: From user signals to task context ](/en/plugins/personal-memory-principles)
  • Project Knowledge: Accumulate reusable project understanding in tasks ](/en/plugins/project-rules)
  • Project Knowledge principle: From project evidence to Task context ](/en/plugins/project-knowledge-principles)
Last modified on August 31, 2026