Add agentic-coding scaffolding (AGENTS.md, CLAUDE.md, session hook) - #137
Open
grzanka wants to merge 2 commits into
Open
Add agentic-coding scaffolding (AGENTS.md, CLAUDE.md, session hook)#137grzanka wants to merge 2 commits into
grzanka wants to merge 2 commits into
Conversation
Make the repo first-class for AI coding agents (Claude Code, opencode, Qwen Code, Codex) so they share one project brief and a reproducible build/test/lint loop: - AGENTS.md: single source of truth — build/test/lint commands, repo map, API model, enforced conventions, generated-data and thread-safety gotchas, definition of done, and how to point opencode at a self-hosted Qwen (OpenAI-compatible) endpoint. - CLAUDE.md: imports AGENTS.md so Claude-specific tooling reads the same brief. - .claude/hooks/session-start.sh: SessionStart hook for Claude Code on the web — configures + builds the debug preset, installs the editable Python binding with dev deps, and exports LIBDEDX_SO so ctest/clang-tidy/pytest work in-session. Idempotent; remote-only. - .claude/settings.json: registers the hook and pre-allows the safe, repeated dev commands (cmake/ctest/ruff/pytest/clang-*/valgrind/git status). https://claude.ai/code/session_01PKNN8m7LaiTseSm1RYkudy
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #137 +/- ##
=======================================
Coverage 72.73% 72.73%
=======================================
Files 12 12
Lines 1643 1643
Branches 300 300
=======================================
Hits 1195 1195
Misses 448 448 ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
Contributor
There was a problem hiding this comment.
Pull request overview
Adds AI-agent onboarding/scaffolding so multiple agent tools can share a single, consistent project brief and an automated “inner loop” setup for Claude Code web sessions.
Changes:
- Add
AGENTS.mdas a shared, tool-agnostic project brief (build/test/lint loop, repo map, API model, conventions, gotchas). - Add
CLAUDE.mdthat imports the shared brief for Claude Code. - Add Claude Code web SessionStart hook + settings to auto-configure/build debug preset, install Python dev deps, and set
LIBDEDX_SO.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
CLAUDE.md |
Points Claude Code to the shared agent brief (AGENTS.md). |
AGENTS.md |
Centralized agent-facing documentation for workflows, structure, and conventions. |
.claude/settings.json |
Registers the session-start hook and declares an allowlist for common dev commands. |
.claude/hooks/session-start.sh |
Automates configure/build + editable Python install + LIBDEDX_SO export in Claude Code web sessions. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- AGENTS.md: spell out DEDX_ICRU49 / DEDX_ICRU73 / DEDX_ICRU73_OLD as separate constants instead of the collapsed DEDX_ICRU49/73/73_OLD form, which could be mistaken for a single (non-existent) symbol. - session-start.sh: only append `export LIBDEDX_SO=...` to CLAUDE_ENV_FILE when not already present, so repeated hook runs don't duplicate the line. https://claude.ai/code/session_01PKNN8m7LaiTseSm1RYkudy
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Make the repo first-class for AI coding agents (Claude Code, opencode,
Qwen Code, Codex) so they share one project brief and a reproducible
build/test/lint loop:
API model, enforced conventions, generated-data and thread-safety
gotchas, definition of done, and how to point opencode at a self-hosted
Qwen (OpenAI-compatible) endpoint.
web — configures + builds the debug preset, installs the editable Python
binding with dev deps, and exports LIBDEDX_SO so ctest/clang-tidy/pytest
work in-session. Idempotent; remote-only.
repeated dev commands (cmake/ctest/ruff/pytest/clang-*/valgrind/git status).
https://claude.ai/code/session_01PKNN8m7LaiTseSm1RYkudy