Skip to content

Add agentic-coding scaffolding (AGENTS.md, CLAUDE.md, session hook) - #137

Open
grzanka wants to merge 2 commits into
mainfrom
claude/libdedx-agentic-setup-n76p6i
Open

Add agentic-coding scaffolding (AGENTS.md, CLAUDE.md, session hook)#137
grzanka wants to merge 2 commits into
mainfrom
claude/libdedx-agentic-setup-n76p6i

Conversation

@grzanka

@grzanka grzanka commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

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

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
@grzanka
grzanka requested a review from Copilot June 8, 2026 20:24
@codecov

codecov Bot commented Jun 8, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 72.73%. Comparing base (36990c2) to head (4812c28).

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.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

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.md as a shared, tool-agnostic project brief (build/test/lint loop, repo map, API model, conventions, gotchas).
  • Add CLAUDE.md that 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.

Comment thread AGENTS.md Outdated
Comment thread .claude/hooks/session-start.sh Outdated
- 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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants