import { SKILL_AUTHORING_HANDOFF_SCHEMA_VERSION, type SkillAuthoringHandoff } from "../skill-authoring-handoff.js"; export declare const SKILL_AUTHORING_PRINCIPLE = "Create the smallest non-redundant Renma asset graph that preserves execution clarity and traceability."; export declare const RENMA_FIRST_AUTHORING_BOUNDARY = "Use Renma to establish repository asset and metadata boundaries first. Use platform-native Skill authoring guidance to refine semantics within those boundaries."; export declare const SKILL_AUTHORING_GUIDE_SCHEMA_VERSION: "renma.skill-authoring-guide.v2"; export declare const AUTHORING_VALIDATION_RULE = "After authoring or changes, run `renma scan . --fail-on high` and all repository-required checks for the current change and stage."; export declare const AUTHORING_REPORTS_RULE = "Beyond required checks, use `renma inspect`, `renma catalog`, `renma graph`, or `renma readiness` only when they answer a current structural or governance question."; export declare const AUTHORING_REVALIDATION_RULE = "After relevant checks pass, repeat or broaden validation only for further changes, failed checks, or unresolved concerns. Reuse existing evidence only while it remains applicable to the current content, environment, and required scope. Required CI and release checks still apply."; export interface SkillAuthoringProgressionClasses { blocking: string; reversibleDefault: string; deferred: string; } export interface SkillAuthoringUnknownScopes { authoringDecision: string; runtimeTaskUnknown: string; } export interface SkillAuthoringUnresolvedItemDispositions { askNow: string; queueAsBlocker: string; proceedWithReversibleDefault: string; defer: string; reportAsFinding: string; } export interface SkillAuthoringProgressionSummary { blocking: string[]; reversibleDefaults: string[]; deferred: string[]; queuedBlockers: string[]; } export interface SkillAuthoringClarificationExample { request: string; confirmed: string[]; proposed: string[]; unresolved: string[]; questions: string[]; progression?: SkillAuthoringProgressionSummary; runtimeTaskUnknowns?: string[]; } export interface SkillAuthoringInteraction { openingRule: string; phases: string[]; truthSources: string[]; decisionClasses: { confirmed: string; proposed: string; unresolved: string; }; unknownScopes: SkillAuthoringUnknownScopes; progressionClasses: SkillAuthoringProgressionClasses; unresolvedItemDispositions: SkillAuthoringUnresolvedItemDispositions; questionRules: string[]; creationGate: string[]; postValidationActions: string[]; persistenceRules: string[]; handoffRules: string[]; humanReviewRules: string[]; } export interface SkillAuthoringIllustration { id: string; title: string; demonstrates: string[]; notice: string; request: string; clarification: Omit; initialStructure?: string[]; responsibilities?: { skill?: string[]; context?: string[]; }; sourceReference?: string; additionalReview?: string[]; verification?: string[]; notCreatedByDefault?: string[]; } export interface SkillAuthoringGuidance { schemaVersion: typeof SKILL_AUTHORING_GUIDE_SCHEMA_VERSION; topic: "skill"; renmaVersion: string; principle: string; handoff: SkillAuthoringHandoffGuidance; interaction: SkillAuthoringInteraction; workflow: string[]; placementRules: string[]; artifactRules: string[]; concisenessRules: string[]; metadataRules: string[]; externalTraversalApplicabilityRule: string; externalTraversalRules: string[]; illustrationRules: string[]; illustrations: SkillAuthoringIllustration[]; verification: string[]; } export interface SkillAuthoringHandoffGuidance { schemaVersion: typeof SKILL_AUTHORING_HANDOFF_SCHEMA_VERSION; purpose: string; boundary: string; rules: string[]; template: SkillAuthoringHandoff; } /** Build the single structured source used by every Skill guide projection. */ export declare function buildSkillAuthoringGuidance(renmaVersion: string): SkillAuthoringGuidance;