From 37a1669463a0af425aca9ea334f9c7f428f10063 Mon Sep 17 00:00:00 2001 From: mike Date: Fri, 12 Sep 2025 23:26:17 +0000 Subject: [PATCH 1/2] CRQ-54: Document deterministic CRQ parser --- .../CRQ-54-agent-communication-analysis.md | 36 +++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 docs/crq_standardized/CRQ-54-agent-communication-analysis.md diff --git a/docs/crq_standardized/CRQ-54-agent-communication-analysis.md b/docs/crq_standardized/CRQ-54-agent-communication-analysis.md new file mode 100644 index 0000000..56adad9 --- /dev/null +++ b/docs/crq_standardized/CRQ-54-agent-communication-analysis.md @@ -0,0 +1,36 @@ +# CRQ-54: Agent Communication Mirroring and Analysis + +## Objective + +To establish a robust system for mirroring and analyzing communications between human developers and AI agents (e.g., CodeRabbitAI) within the project's Pull Request workflow. This includes: + +1. Mirroring PR descriptions and comments to the local file system, structured by CRQ. +2. Developing tools to analyze these mirrored communications to extract predicates, traits, and patterns of interaction. +3. Facilitating the development of a "proc file system" for agent interactions to enable programmatic analysis and understanding of agent behavior and contributions. + +## Scope + +* Development of scripts to fetch PR data and comments from GitHub and store them as Markdown files with YAML front matter. +* Implementation of a Rust program (`response_analyzer`) to parse these Markdown files and extract predefined predicates and traits. +* Integration of these tools into the development workflow to automatically capture and analyze agent communications. + +## Deliverables + +* `mirror_pr_to_fs.sh`: Script to mirror PRs and comments to the file system. +* `ping_coderabbitai.sh`: Script to conditionally ping CodeRabbitAI. +* `process_all_crq_branches.sh`: Orchestration script to process all CRQ branches for mirroring. +* `response_analyzer` Rust crate: Program to analyze mirrored responses and extract predicates. +* Updated documentation on the process and analysis results. + +## Dependencies + +* GitHub CLI (`gh cli`) +* `jq` (for JSON parsing) +* Rust toolchain +* Existing CRQ branches for data collection. + +## Success Criteria + +* All relevant PRs and their comments are successfully mirrored to the local file system in the specified `comms/git//` structure. +* The `response_analyzer` program successfully extracts defined predicates and traits from the mirrored data. +* The analysis provides actionable insights into agent communication patterns and effectiveness. From b43d0114c48707af534401101da1a29f1a496c34 Mon Sep 17 00:00:00 2001 From: mike Date: Sat, 13 Sep 2025 00:15:16 +0000 Subject: [PATCH 2/2] Docs: Add .emacs.d/ to .gitignore --- .gitignore | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/.gitignore b/.gitignore index 6e2b54a..9a4c56f 100644 --- a/.gitignore +++ b/.gitignore @@ -6,4 +6,6 @@ target/ result result/ submodule_collector_strace.log -*~ \ No newline at end of file +*~ +.emacs.d/ +