Skip to content

nanaagyei/noetherkin / skills/task-assignment

task-assignment

Verified

Define a bounded, testable Noetherkin assignment and its investigation prompt without revealing the solution. Use when a learner requests next work or a manager recommends new scope; execution gates belong to team-lead.

FileKindSize
SKILL.mdskill md3.7 KB
assets/proposal.mdmarkdown2.0 KB
references/FOUNDATION_V1.mdmarkdown5.4 KB
references/OPEN_QUESTIONS.mdmarkdown3.5 KB
references/PROJECT_CHARTER.mdmarkdown6.4 KB
references/apprenticeship-config.schema.jsonconfig3.0 KB
references/architectural-invariants.mdmarkdown2.3 KB
references/assessment.schema.jsonconfig5.0 KB
references/assistance-model.mdmarkdown4.0 KB
references/attention-advisory.schema.jsonconfig3.8 KB
references/bundle.jsonconfig12.0 KB
references/cli.mdmarkdown18.6 KB
references/competencies.yamlconfig37.7 KB
references/competency-model.mdmarkdown5.0 KB
references/competency-state.schema.jsonconfig3.4 KB
references/conformance.mdmarkdown22.0 KB
references/contract-README.mdmarkdown6.9 KB
references/contract-manager.mdmarkdown2.4 KB
references/contract-task-assignment.mdmarkdown3.2 KB
references/contract-team-lead.mdmarkdown2.8 KB
references/current-project.schema.jsonconfig2.3 KB
references/current-track.schema.jsonconfig1.5 KB
references/evidence-model.mdmarkdown4.1 KB
references/evidence.schema.jsonconfig10.3 KB
references/forge.schema.jsonconfig9.5 KB
references/index.mdmarkdown3.6 KB
references/judgment-validity.mdmarkdown6.6 KB
references/learner-profile.schema.jsonconfig1.5 KB
references/leveling-framework.mdmarkdown3.4 KB
references/levels.yamlconfig8.0 KB
references/overview.mdmarkdown2.9 KB
references/permissions-model.mdmarkdown6.7 KB
references/project.schema.jsonconfig9.4 KB
references/proposals.mdmarkdown4.2 KB
references/review-model.mdmarkdown7.2 KB
references/review.schema.jsonconfig13.0 KB
references/runtime.mdmarkdown7.8 KB
references/selection-model.mdmarkdown6.1 KB
references/simulation-lifecycle.mdmarkdown8.0 KB
references/state-model.mdmarkdown13.7 KB
references/task.schema.jsonconfig13.8 KB
references/track.schema.jsonconfig1.3 KB

references/forge.schema.json

View on GitHub
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://engineering-apprenticeship.example/schemas/3.0/forge.schema.json",
  "title": "forge",
  "description": "PROPOSED under ACP-015. Not normative. A first-party specification the learner builds from. This repository owns the specification and the task pack; it never ships a solution.",
  "type": "object",
  "required": [
    "schema_version",
    "data_class",
    "id",
    "name",
    "description",
    "status",
    "track_alignment",
    "competencies",
    "recommended_minimum_level",
    "ideal_level",
    "primary_languages",
    "technologies",
    "external_services",
    "problem",
    "users",
    "success_criteria",
    "non_goals",
    "operational_requirements",
    "context_budget",
    "prerequisites",
    "task_packs",
    "caveats",
    "sources",
    "checked_at"
  ],
  "additionalProperties": false,
  "properties": {
    "schema_version": {
      "enum": [
        "1.0"
      ]
    },
    "data_class": {
      "enum": [
        "live",
        "fixture"
      ]
    },
    "id": {
      "type": "string",
      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
      "minLength": 1
    },
    "name": {
      "type": "string",
      "minLength": 1
    },
    "description": {
      "type": "string",
      "minLength": 1
    },
    "status": {
      "enum": [
        "draft",
        "supported",
        "deprecated"
      ]
    },
    "track_alignment": {
      "description": "Track IDs whose required_competencies this specification exercises. At least one; a forge project that teaches nothing on any track does not belong in the catalog.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "minItems": 1,
      "uniqueItems": true
    },
    "competencies": {
      "description": "Catalog competency IDs. References, never scores or levels.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "minItems": 1,
      "uniqueItems": true
    },
    "recommended_minimum_level": {
      "enum": [
        "E0",
        "E1",
        "E2"
      ]
    },
    "ideal_level": {
      "enum": [
        "E0",
        "E1",
        "E2"
      ]
    },
    "primary_languages": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "minItems": 1,
      "uniqueItems": true
    },
    "technologies": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "uniqueItems": true
    },
    "external_services": {
      "description": "Third-party services the finished system requires. Empty is the preferred value; each entry is a dependency the learner must obtain before starting.",
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "purpose",
          "substitutable"
        ],
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1
          },
          "purpose": {
            "type": "string",
            "minLength": 1
          },
          "substitutable": {
            "description": "Whether a local or offline stand-in is acceptable. False means the learner cannot start without it.",
            "type": "boolean"
          }
        }
      },
      "uniqueItems": true
    },
    "problem": {
      "description": "What is wrong in the world without this system. Stated as a situation, not as a list of features to implement.",
      "type": "string",
      "minLength": 1
    },
    "users": {
      "description": "Who runs this and what they are trying to accomplish. At least one, because 'genuinely usable by someone other than the learner' is an entry requirement.",
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "who",
          "needs"
        ],
        "additionalProperties": false,
        "properties": {
          "who": {
            "type": "string",
            "minLength": 1
          },
          "needs": {
            "type": "string",
            "minLength": 1
          }
        }
      },
      "minItems": 1
    },
    "success_criteria": {
      "description": "Observable properties of the finished system. Each must be checkable by someone who did not write it. These describe the whole project; per-task acceptance criteria live in the task records.",
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "criterion",
          "verifiable_by"
        ],
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^SC-[0-9]+$"
          },
          "criterion": {
            "type": "string",
            "minLength": 1
          },
          "verifiable_by": {
            "description": "How an outside reviewer confirms this without trusting a claim.",
            "type": "string",
            "minLength": 1
          }
        }
      },
      "minItems": 1
    },
    "non_goals": {
      "description": "Explicitly out of scope. Present to bound the work, because an unbounded specification cannot meet its context budget.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "minItems": 1,
      "uniqueItems": true
    },
    "operational_requirements": {
      "description": "What the system must do to be operable, not merely correct. This is what distinguishes a forge project from an exercise and gives production-readiness something real to assess.",
      "type": "object",
      "required": [
        "failure_modes",
        "observability",
        "rollback",
        "documentation"
      ],
      "additionalProperties": false,
      "properties": {
        "failure_modes": {
          "description": "Failures the system must handle explicitly, each with the required behavior.",
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "failure",
              "required_behavior"
            ],
            "additionalProperties": false,
            "properties": {
              "failure": {
                "type": "string",
                "minLength": 1
              },
              "required_behavior": {
                "type": "string",
                "minLength": 1
              }
            }
          },
          "minItems": 1
        },
        "observability": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "minItems": 1,
          "uniqueItems": true
        },
        "rollback": {
          "description": "How a bad change is undone. 'Not applicable' is not an acceptable value; state the actual procedure.",
          "type": "string",
          "minLength": 1
        },
        "documentation": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "minItems": 1,
          "uniqueItems": true
        }
      }
    },
    "context_budget": {
      "description": "Target size of the finished artifact. Advisory and revisable against ACP-016 measurements; stated because an unstated budget is not a constraint.",
      "type": "object",
      "required": [
        "source_tokens_target",
        "excludes",
        "rationale"
      ],
      "additionalProperties": false,
      "properties": {
        "source_tokens_target": {
          "type": "integer",
          "minimum": 1
        },
        "excludes": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "minItems": 1,
          "uniqueItems": true
        },
        "rationale": {
          "type": "string",
          "minLength": 1
        }
      }
    },
    "prerequisites": {
      "description": "What the learner must already be able to do. Prose, not competency IDs; competency fit is carried by the competencies field.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "uniqueItems": true
    },
    "task_packs": {
      "description": "Task pack IDs. Non-empty by construction: a forge record with no authored tasks is rejected. This is the rule that stops the forge catalog repeating the breadth-without-depth problem of the upstream project catalog.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "minItems": 1,
      "uniqueItems": true
    },
    "caveats": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "minItems": 1,
      "uniqueItems": true
    },
    "sources": {
      "description": "Where the problem statement came from. Empty is permitted for an invented problem; an entry claims a real need and must be checkable.",
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "uri",
          "description",
          "revision"
        ],
        "additionalProperties": false,
        "properties": {
          "uri": {
            "type": "string",
            "format": "uri"
          },
          "description": {
            "type": "string",
            "minLength": 1
          },
          "revision": {
            "type": "string",
            "minLength": 1
          }
        }
      },
      "uniqueItems": true
    },
    "checked_at": {
      "type": "string",
      "format": "date-time"
    }
  }
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall