Add CONTEXT.md for AI agent consumption

[Debashich]

Add a concise CONTEXT.md describing common tkn workflows,

conventions, output formats, and behavioral notes for AI agents.

Fixes #2856

Assisted-by: Claude Sonnet 4.6

Changes

• Add a new CONTEXT.md file documenting common tkn workflows, conventions, output formats, and behavioral guidance for AI agents.

• Ran make check locally. The command fails because of existing lint issues in unrelated files, no new issues were introduced by this documentation only change.

Submitter Checklist

These are the criteria that every PR should meet, please check them off as you
review them:

• Includes tests (if functionality changed/added)
• Run the code checkers with make check
• Regenerate the manpages, docs and go formatting with make generated
• Commit messages follow commit message best practices

See the contribution guide
for more details.

Release Notes

[tekton-robot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
To complete the pull request process, please assign vinamra28 after the PR has been reviewed.
You can assign the PR to them by writing /assign @vinamra28 in a comment when ready.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: Debashich / name: Debashich (e59eb97)

[Debashich]

Hi @vdemeester, this PR is ready for review whenever you have a chance. It implements the CONTEXT.md proposed in #2856. Thanks!

[divyansh42]

Thanks for the PR @Debashich

I have added few comments. Please take a look and let me know what you think about it.

The document covers pipeline, task, pipelinerun, and taskrun. The CLI also supports other resources (customrun, eventlistener, triggerbinding, triggertemplate, clustertriggerbinding, bundle, hub). A brief one-liner acknowledging their existence would prevent agents from assuming these four are the only resources — something like:

Other resource types (eventlistener, triggerbinding, triggertemplate, customrun, clustertriggerbinding) support subsets of list, describe, and delete.

[divyansh42]

It seems export command is not present in the task. Can you please check once?
Ref: https://github.com/tektoncd/cli/blob/main/pkg/cmd/task/task.go#L40

[Debashich]

I verified it and made changes accordingly. Thanks for pointing this out!

[divyansh42]

It seems --output flag is supported for the start commands which has the option for json output.

[Debashich]

Addressed

[divyansh42]

Missing an important flag for scripting/agent use: --exit-with-pipelinerun-error / -E, available on pipelinerun logs and pipeline start. This flag is essential for the Exit Codes section to be useful, and an agent doing CI automation would need it.

Consider adding:

--exit-with-pipelinerun-error, -E | pipelinerun logs, pipeline start | Exit with run status (0=success, 1=failed, 2=unknown)

[Debashich]

Added!

[Debashich]

Thanks for the review and the detailed feedback, @divyansh42
I've addressed all of the requested changes above.Please let me know if you notice anything else that should be adjusted. Thanks again for the thorough review!

[divyansh42]

@Debashich with changes merged recently #2925
Could you please add the same to your PR.

[divyansh42]

Thanks for addressing the earlier feedback! A couple of things still remain:

• The Resource Types table dropped export entirely — but pipeline, pipelinerun, and taskrun still have it (only task doesn't). The Output Formats and Behavioral Notes sections still reference export, so it should stay in the table for the resources that support it.
• --output json in the Common Flags table only lists pipeline start, but task start supports it too.