Skip to content

Add AI-assisted TechDocs Assessment spec #363

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nate-double-u wants to merge 47 commits into
base: main
Choose a base branch
from
+1,057 −0
Open

Add AI-assisted TechDocs Assessment spec #363

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
47 commits
Select commit Hold shift + click to select a range
92e24b8
Add AI-assisted TechDocs Assessment spec
nate-double-u Aug 11, 2026
e231356
Address review: approver independence; propose per-file issue backlog
nate-double-u Aug 11, 2026
84d0c8f
Address review: approver independence, per-file backlog proposal; fix CI
nate-double-u Aug 11, 2026
a935600
Restructure spec into Part I (requirements) and Part II (operational)
nate-double-u Aug 11, 2026
314d003
Move spec to docs/ top level, keeping the methodology corpus clean
nate-double-u Aug 11, 2026
aac77f1
Add section 11: platform binding to Copilot cloud agent
nate-double-u Aug 11, 2026
e3714aa
Add section 12: lifecycle bindings to GitHub primitives
nate-double-u Aug 11, 2026
7edd538
Add section 13: components and repository layout
nate-double-u Aug 11, 2026
ac0ac1a
Relabel platform owner to administrator/platform owner; drop arbitration
nate-double-u Aug 11, 2026
4b8125b
Add section 14: agent definitions
nate-double-u Aug 11, 2026
f981754
Add verifier: an adversarial agent fact-check pass before human review
nate-double-u Aug 11, 2026
f05c640
Add section 15: the provenance block
nate-double-u Aug 11, 2026
0abc465
Move spec to specs/, out of the website-synced tree
nate-double-u Aug 11, 2026
96f2fec
Note the website intake page as future work
nate-double-u Aug 11, 2026
86680b0
Add section 16: the build plan
nate-double-u Aug 11, 2026
04a0eaf
Refresh open questions: collect build-time checks, drop answered item
nate-double-u Aug 11, 2026
95c928c
Preserve the methodology's phase B skip path and issue time bound
nate-double-u Aug 11, 2026
c2ae7ac
Report cycle time; do not gate acceptance on it
nate-double-u Aug 11, 2026
95729f7
State model policy as capability requirements, not model names
nate-double-u Aug 11, 2026
4feb4f6
Correct platform claims: PR cap, firewall scope, secrets vector
nate-double-u Aug 11, 2026
3a8e7f2
Make the disclosure status-aware; pin one methodology per assessment
nate-double-u Aug 11, 2026
fb6a5f4
Pin the verification floor; snapshot agent config from the API
nate-double-u Aug 11, 2026
9a5e7ac
Drop the approval claim from the disclosure's final form
nate-double-u Aug 11, 2026
9ef5603
Narrow HC-4 to agent content; exempt gate-fired bookkeeping
nate-double-u Aug 11, 2026
bb51e34
Pin data sources: repo SHAs and site retrieval dates
nate-double-u Aug 11, 2026
1a237cc
Cite the config endpoint; close two deferral loops
nate-double-u Aug 11, 2026
ff954ec
Scope HC-4 to repository content
nate-double-u Aug 11, 2026
359de3f
Profiles can pin a model; ours choose not to
nate-double-u Aug 11, 2026
0e691c2
Pin the methodology by commit SHA, not by ref
nate-double-u Aug 11, 2026
ffb3166
Run data collection in the session's setup steps
nate-double-u Aug 11, 2026
2f6ab6f
Disclose to the project before drafting, whoever filed
nate-double-u Aug 11, 2026
a0e14dd
Extend the verification floor to unrated phases
nate-double-u Aug 11, 2026
60d7307
Let the methodology, not this spec, set the backlog layout
nate-double-u Aug 11, 2026
1bfdcfd
Bind P-2's reproducibility pin to a commit SHA
nate-double-u Aug 11, 2026
c14e878
Profiles run only when a writer selects them
nate-double-u Aug 11, 2026
2d7b779
Name the setup-targeting unknown; align backlog wording
nate-double-u Aug 12, 2026
831ed27
spec: bind lifecycle to slash commands, labels, and an umbrella intak…
nate-double-u Aug 12, 2026
1e83675
spec: give /confirm teeth and close command-binding gaps from review
nate-double-u Aug 12, 2026
a58556b
spec: bring concurrent assessments into scope
nate-double-u Aug 12, 2026
619189b
spec: authorize /confirm against a stakeholder set frozen at acceptance
nate-double-u Aug 12, 2026
761709b
spec: test deterministically in CI, live on the consenting pilot
nate-double-u Aug 12, 2026
9aa7dd1
spec: close label-trust, terminal-state, and site-pin gaps
nate-double-u Aug 12, 2026
0bdb602
spec: add a participant guide so the system documents itself
nate-double-u Aug 13, 2026
e192802
spec: name budget as the constraint and experts as the loop
nate-double-u Aug 13, 2026
9e91a8a
answer the pass-eight review: reassessment, manifests, fallbacks
nate-double-u Aug 13, 2026
2f872d5
name the per-phase and skip labels in section 13
nate-double-u Aug 13, 2026
09a92bf
build components locally with Copilot CLI; move platform observation …
nate-double-u Aug 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .cspell.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,19 +20,26 @@ ignorePaths:
# ignoreRegExpList:
# - CodeBlock
words:
- agentic
- backstore
- bottlenecking
- Chalin
- CLOTributor
- CNCF
- cncf
- consumability
- Docsy
- dwelsch
- exfiltrate
- fluxcd
- github
- howto
- keda
- knative
- kedacore
- krator
- krook
- llms
- mkdocs
- nate
- nvmrc
Expand Down
Loading