1  ;; SPDX-License-Identifier: AGPL-3.0-or-later
 2  ;; SPDX-FileCopyrightText: 2025 Hyperpolymath Contributors
 3  ;;
 4  ;; AGENTIC.scm - AI/Agent interaction policies for this repository
 5  
 6  (agentic
 7   (version 1)
 8   (project "bebop-v-ffi")
 9  
10   (agent-role
11    (primary "design-assistant")
12    (description "AI assists with design, docs, and examples but does not author ABI changes"))
13  
14   (boundaries
15    (can-do
16     "Propose API shapes and struct layouts"
17     "Draft documentation and examples"
18     "Explain existing code and design rationale"
19     "Suggest test cases and edge conditions"
20     "Review code for common FFI pitfalls"
21     "Generate V usage examples")
22  
23    (cannot-do
24     "Modify include/bebop_v_ffi.h without human review"
25     "Change serialization logic"
26     "Alter build system (build.zig, Cargo.toml)"
27     "Push commits directly"
28     "Refactor across language boundaries"
29     "Migrate between implementations"))
30  
31   (review-gates
32    ((artifact "ABI header changes")
33     (requires human-sign-off)
34     (reason "ABI stability is core deliverable"))
35    ((artifact "Serialization logic")
36     (requires human-sign-off)
37     (reason "Wire format correctness critical"))
38    ((artifact "Build scripts")
39     (requires human-sign-off)
40     (reason "Toolchain changes affect all consumers")))
41  
42   (interaction-style
43    (verbosity concise)
44    (code-generation cautious)
45    (proactive-suggestions allowed)
46    (explain-before-act required))
47  
48   (trust-escalation
49    (default-level "propose-only")
50    (escalation-path
51     "propose-only -> draft-with-review -> implement-with-approval")))