Skip to content

docs(agent-notes): commit 6 standing reference docs (Tick API + Asana list + custom fields recon)#22

Merged
JOBYINC merged 1 commit into
previewfrom
docs/agent-notes
May 21, 2026
Merged

docs(agent-notes): commit 6 standing reference docs (Tick API + Asana list + custom fields recon)#22
JOBYINC merged 1 commit into
previewfrom
docs/agent-notes

Conversation

@JOBYINC
Copy link
Copy Markdown
Owner

@JOBYINC JOBYINC commented May 21, 2026

Why

These six docs have been living as untracked files on a local working tree for weeks — they have already stabilized into reference material that the JOBY agent team and engineering rely on day-to-day. Promoting them out of limbo so they version with the code they document.

What

File Purpose
`docs/asana-list-architecture.md` (131 lines) Asana-style list view architecture decision, ratified 2026-05-17
`docs/asana-list-plan.md` (60) F1 + F2 implementation plan, ratified 2026-05-17
`docs/custom-fields-token-api.md` (143) Public token-API reference — the surface JOBY agents (GTM Director, HR, etc.) use to write structured custom-field data into Tick
`docs/spreadsheet-recon.md` (240) Recon notes for the `feature/custom-fields-spreadsheet` direction
`docs/tick-primer.md` (97) Paste-into-system-prompt primer — what every JOBY agent needs to know to call Tick
`docs/tick-agent-reference.md` (706) Full Tick API reference companion to the primer

Total: 1,377 lines of docs, 0 code change.

Security

Scanned for hardcoded credentials. All matches are secret NAMES, not values:

  • `PLANE_API_KEY` (env var name)
  • `X-Api-Key` (header name)

No tokens, passwords, API keys, or other secret values are committed. The docs describe how to use the secret-injection pattern, not what any specific key is.

Test plan

  • CI green
  • No code paths changed; nothing to functionally test
  • If `tick-agent-reference.md` is edited again in the future, the joby-plane skill mirror needs re-syncing + SKILL.md bump (per ops memory)

Working-notes that have stabilized into reference material the JOBY agent
team and engineering rely on day-to-day; promoting them out of untracked
limbo on local working trees into the repo so they version with the code
they document.

- asana-list-architecture.md — Asana-style list view architecture decision (2026-05-17)
- asana-list-plan.md — F1+F2 implementation plan, ratified 2026-05-17
- custom-fields-token-api.md — public token-API reference for the JOBY agents writing structured Tick data
- spreadsheet-recon.md — recon notes for feature/custom-fields-spreadsheet
- tick-primer.md — paste-into-system-prompt primer for any agent that needs to talk to Tick
- tick-agent-reference.md — full Tick API reference companion to tick-primer.md

No secrets: scan confirms only secret NAMES (PLANE_API_KEY, X-Api-Key header)
appear, never values.
@JOBYINC JOBYINC merged commit 93e0672 into preview May 21, 2026
8 checks passed
@JOBYINC JOBYINC deleted the docs/agent-notes branch May 21, 2026 20:29
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.

1 participant