Skip to content

skills(ankra-applications): document .ankra/ankra.yaml and its components block (ankra-8k4lo.14) - #430

Merged
Myothas merged 1 commit into
masterfrom
docs/ankra-8k4lo.14-skill-descriptor
Oct 5, 2026
Merged

Myothas merged 1 commit into
masterfrom
docs/ankra-8k4lo.14-skill-descriptor

Conversation

@Myothas

@Myothas Myothas commented Oct 5, 2026

Copy link
Copy Markdown
Member

Narrow update to the embedded ankra-applications skill (the embedded copy is canonical; ankraio/ankra-skills does not exist).

  • SKILL.md §2 (Review what Ankra generated): the setup PR also carries .ankra/ankra.yaml; what metadata and options are, and that an optional components: block declares a monorepo's components, outranks the existing workflows, the AI proposal and structural detection, is the only way to remove a component, and is refused whole as the read_declared_components setup task with the recorded components kept.
  • reference.md (Monorepo components): the declaration example (Go API at the root built from deploy/docker/Dockerfile plus web/) and the name/path rules.

Both link the new reference page https://docs.ankra.ai/reference/application-descriptor (ankraio/ankra-docs#478, merged). Schema source: cluster enginekit/appdescriptor/components.go (cluster#3916).

go test ./internal/skills/ passes; the pre-commit gate (go test ./..., golangci-lint) passed.

Bead: ankra-8k4lo.14

🤖 Generated with Claude Code

…ents block

The setup PR carries the application descriptor; say what it holds (metadata,
the deploy options contract) and that a components: block declares a
monorepo's components, outranks every inferred signal, is the only way to
remove a component, and is refused whole as the read_declared_components
task. reference.md gets the Cadence-shaped declaration example. Both link
the new docs reference page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Myothas
Myothas marked this pull request as ready for review October 5, 2026 19:04
@ankra-platform

ankra-platform Bot commented Oct 5, 2026 •

Copy link
Copy Markdown

Ankra AI review

Verdict: looks good.

Docs-only change adding documentation for the .ankra/ankra.yaml application descriptor and its components block. The content is consistent between SKILL.md and reference.md and describes sensible precedence semantics. One minor uncertainty about how the fenced code blocks are written in the markdown source.


Reviewed commit 3e7c0e5. This review is read-only and advisory.

@Myothas
Myothas merged commit b7dd200 into master Oct 5, 2026
3 checks passed
@Myothas
Myothas deleted the docs/ankra-8k4lo.14-skill-descriptor branch October 5, 2026 19:21
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