Spec-Driven Cognitive Scaffolding (SDCS) Framework
A formal, file-based cognitive harness for autonomous agentic software engineering conforming to SPEC-001.
Specifications
- SPEC-001 (v1.4.0): Single-Agent Cognitive Harness — The active specification governing repository-level working memory, negative decisions, and cryptographic test verification.
The Problem: The Failure of Monolithic Prompting
Autonomous coding agents typically fail not because of underlying model capability, but because of context conflation. When all operational logic, temporary thoughts, file directories, and project history are crammed into a single system prompt or chat log, three fatal pathologies emerge:
- Context Drift: As conversational message counts increase, core architectural constraints and safety rules get diluted and pushed out of the model's effective attention window.
- Cartographic Hallucination: Lacking a persistent, explicit map of the codebase, agents enter token-wasting brute-force search loops (
find,grep) or hallucinate non-existent files and interfaces. - Episodic Amnesia: Agents possess no structured negative memory. When restarted or encountering a rollback, they repeatedly re-attempt architectural decisions that were already measured and rejected in prior sessions.
Root Cause: Monolithic prompts conflate invariant rules, ephemeral scratchpad state, module cartography, and historical audit logs into a single bloated context window.
The Core Cognitive Topography
SDCS decouples agent cognition into seven purpose-built files plus an isolated flight recorder:
| # | File | Pillar Role | Analogy | Description |
|---|---|---|---|---|
| 1 | spine.md |
Constitutional Invariants | The Law | Immutable domain axioms, verification gates, and forbidden actions. |
| 2 | wiring.yaml |
Declarative Topology | The Mesh | Component boundaries, service mesh, interface bindings, and contracts. |
| 3 | roadmap.md |
Acceptance Contract | The North Star | High-level human intent vs. measured empirical reality ([INTENT] vs [MEASURED]). |
| 4 | state.md |
Dynamic Working Memory | The Whiteboard | Active milestone objectives, immediate blockers, and pending gates (~300 token budget). |
| 5 | app_map.md |
Repository Cartography | The Compass | Structural index of modules and responsibilities consulted prior to file access. |
| 6 | decisions.md |
Negative Episodic Memory | The Graveyard | Rejection log of measured dead ends (Claim → Measurement → Reopen Condition). |
| 7 | evals.md |
Positive Episodic Memory | The Scorecard | Benchmark standing, golden test fixtures, and SHA-256 diversity guards. |
| + | sessions/*.md |
Historical Handoff Logs | The Flight Recorder | Discrete, immutable post-shift engineering handoffs. Never ingested on system boot. |
Architectural Lineage & Theoretical Foundations
SDCS is not reinventing software theory; it is the deliberate, pragmatic application of battle-tested systems programming, distributed systems primitives, and formal methods adapted to constrain probabilistic LLM context windows. When an autonomous agent is given an unconstrained prompt and bash access, it drifts and rationalizes errors. By grounding agent workflows in classical computer science patterns, we achieve deterministic engineering stability:
- The Blackboard Pattern (Erman, Lesser, Hayes-Roth, & Reddy, 1980): Implemented in
state.mdto externalize volatile working memory, adopting Carnegie Mellon's HEARSAY-II pattern where opportunistic reasoning engines read and mutate an isolated, low-budget whiteboard instead of passing unbounded conversational state. - Design by Contract & Formal Invariant Theory (Hoare, 1969; Meyer, 1986): Implemented in
spine.mdas non-negotiable domain axioms, preconditions, and execution gates that cannot be softened, bypassed, or negotiated by agent inference. - Modular Information Hiding (Parnas, 1972): Implemented in
wiring.yamlto enforce explicit component interfaces, runtime contracts, and tool boundaries, containing blast radii and eliminating circular module dependencies. - Optative vs. Indicative Requirements & Cybernetic Control (Wiener, 1948; Brinch Hansen, 1970; Jackson, 1995): Implemented in
roadmap.mdto decouple high-level human intent ([INTENT], optative policy) from measured empirical results ([MEASURED], indicative mechanism), preventing teleological drift and proxy metric optimization. - Virtual Memory Page Tables & The Working Set Model (Denning, 1968; Kruchten, 1995): Implemented in
app_map.mdas an external index of repository cartography, translating high-level task goals into explicit file paths so agents page only necessary dependencies into context rather than thrashing tokens on recursive filesystem scans. - Inverted Architecture Decision Records & Falsification (Popper, 1959; Nygard, 2011): Implemented in
decisions.mdto establish negative episodic memory, inverting classic ADRs into an append-only rejection graveyard that blocks cyclical multi-turn regressions using empirical measurements and concrete reopening criteria. - Cryptographic Content Addressing (Merkle, 1979): Implemented in
evals.mdto bind test fixtures and empirical standing to commit hashes and SHA-256 digests, eliminating the "Phantom Corpus" failure mode where duplicate files masquerade as valid coverage. - Write-Ahead Logging & Append-Only Ledgers (Gray & Reuter, 1992): Implemented in
sessions/*.mdto physically isolate historical, write-once shift handoff records from the volatile execution loop, preventing context poisoning and eliminating git merge conflicts across parallel agents.
Pillars 1 & 2: Boundary & Topology
Constraining an autonomous agent's operational blast radius requires rigorous, explicit boundaries:
spine.md(Constitutional Invariants):- Immutable domain axioms that cannot be prompt-negotiated or overridden by agent assumptions.
- Deterministic verification gates (test runners, linters, coverage baselines).
- Absolute forbidden actions (e.g., modifying invariant definitions, committing secrets, unvetted destructive file ops).
wiring.yaml(Declarative Topology):- Maps the service mesh, subsystem interfaces, and package dependency graph.
- Defines strict tool boundaries and environment runtime contracts.
- Mandates explicit inputs and outputs across components to eliminate circular import loops.
Pillar 3: The Macro Acceptance Contract (roadmap.md)
Without an explicit roadmap.md, autonomous agents suffer from Specification Drift and Scope Creep—they optimize proxy metrics or invent unrequested requirements.
Key Invariants:
- The Strict Dichotomy (
[INTENT]vs[MEASURED]):[INTENT]: The human/client's verbatim requirements for acceptance in production. Not negotiable by an agent, and never to be "improved" by agent inference.[MEASURED]: Empirical numbers, real benchmarks, and verified state directly extracted from tests and code.
- Strictly NO Task Queue:
- Ephemeral, turn-by-turn tasks belong exclusively in
state.md. - Hand-maintained to-do lists in roadmaps inevitably rot, accumulate stale tasks, and misdirect agents.
- Ephemeral, turn-by-turn tasks belong exclusively in
- Telemetry Freshness: Every
[MEASURED]entry must link to a verified commit hash or milestone. Telemetry exceeding the freshness window (30 days / 50 commits) is tagged[STALE].
Pillars 4 & 5: Working Memory & Cartography
Agents frequently burn context windows on recursive filesystem queries. SDCS solves this with a two-tiered spatial memory:
state.md(The Blackboard - Pillar 4):- Houses ephemeral, turn-by-turn ground truth: current active objective, immediate blockers, and active test gates.
- Strict ~300 Token Budget: Pruned and overwritten after every completed subtask or milestone.
- Read on Turn 1 boot so the agent immediately knows where it left off without reading conversation history.
app_map.md(Codebase Cartography - Pillar 5):- A structured index of modules, entry points, and structural responsibilities.
- The Golden Rule: The agent consults
app_map.mdfirst, reading only the specific target files required for the task. - Eliminates exhaustive brute-force search loops across large codebases.
- Hierarchical Monorepo Scaling: For enterprise codebases (>50 modules, >1,000 files), root
app_map.mdindexes subsystem interfaces (<1,000 tokens), while individual packages (e.g.services/auth/app_map.md) maintain nested cartography loaded on demand.
Symmetric Episodic Memory
Episodic memory must be bidirectional: an agent must know what failed just as clearly as what passed.
Pillar 6: Negative Episodic Memory (decisions.md)
Without negative episodic memory, an agent encountering an edge case will repeatedly re-attempt hypotheses that failed in earlier sessions. decisions.md acts as an auditable Rejection Graveyard, enforcing a mandatory 3-part schema:
## REJ-014: Morphological Closing Filter on Subfloor Mask
THE CLAIM:
Applying a 5x5 closing filter bridges broken line segments.
THE MEASUREMENT:
Halved room precision from 86.4% -> 43.1%; spawned 14 phantom polygons across bathroom fixtures.
WHAT WOULD REOPEN IT:
Blueprints scanned at < 150 DPI where contour continuity drops below 30%.
- The Claim: The optimization, algorithm, or refactor attempted.
- The Measurement: Empirical metric or test result demonstrating why it failed.
- What Would Reopen It: Concrete, falsifiable trigger required before any agent may retry the approach.
Pillar 7: Positive Ground Truth & Standing (evals.md)
To prevent the Phantom Corpus Trap (where agents report illusory 100% test pass rates across files that are actually duplicate copies or empty templates), evals.md enforces cryptographic fixture verification:
- Empirical Standing: Defines current verified baseline performance anchored to git commit hashes.
- Corpus Diversity Invariant: Every golden benchmark fixture is cryptographically fingerprinted via SHA-256 digests. Duplicate byte-identical files under different names trigger an immediate audit halt.
- Freshness Contract: Expiration limits that require re-measuring baseline scores when dependencies or model weights update.
Working Memory vs. Shift Handoff: The Flight Recorder Protocol
A critical failure mode of agent architectures is token exhaustion caused by auto-loading historical conversation logs on boot. SDCS enforces a strict boundary between working memory and historical shift archives:
| Artifact | Role | Lifecycle | Agent Ingestion |
|---|---|---|---|
state.md |
The Whiteboard (Active Working Memory) | Constantly overwritten and pruned | Always read on Turn 1. Contains only active objectives, immediate blockers, and current verification status (~300 tokens). |
sessions/*.md |
The Flight Recorder (Shift Handoff Log) | Write-once, append-only discrete files | CRITICAL INVARIANT: NEVER ingested on system boot. Queried on demand only when an agent needs targeted forensic context. |
Why Discrete Files Beat One Monolithic sessions.md
- Zero Git Merge Conflicts: Concurrent agent workers across separate branches never collide on a shared append-only log.
- Deterministic Context Retrieval: Target specific sessions (e.g.,
sessions/2026-09-19_state-machine.md) via targeted grep instead of ingesting a 30,000-token diary. - Natural Checkpointing: Every discrete file acts as an immutable, timestamped snapshot of that engineering shift.
The Autonomous Execution Cycle
SDCS transforms passive static files into a deterministic, 4-phase continuous execution engine:
- Phase 1: Orientation
- Hydrate constraints and current ground truth in strict order:
spine.md→roadmap.md→app_map.md→decisions.md→evals.md→state.md.
- Phase 2: Planning
- Formulate atomic diffs against
state.md. - Read
wiring.yaml+ strictly relevant target files identified viaapp_map.md.
- Formulate atomic diffs against
- Phase 3: Execution
- Apply isolated code mutations.
- Run empirical verification gates defined in
evals.md(linters, test suites, benchmarks).
- Phase 4: Close-Out
- Prune and update
state.md. - Append rejected hypotheses to
decisions.md. - Write an immutable flight recorder log in
sessions/YYYY-MM-DD_<topic>.md.
- Prune and update
Lossless Compaction: The "Prepare for Compact" Protocol
In long engineering sessions spanning dozens of turns, AI context windows inevitably fill up. Development environments (such as Claude Code's /compact, Cursor chat resets, Aider history truncations, or LLM context window roll-offs) periodically summarize or prune the conversation transcript. When an un-scaffolded agent undergoes compaction, it suffers from Compaction Amnesia: active hypothesis chains, test gate states, unrecorded dead ends, and mental model cartography are wiped out. The agent wakes up on post-compact Turn 1 confused, prone to regression, and repeating measured errors.
SDCS eliminates Compaction Amnesia through the Mid-Shift Checkpoint Protocol ("prepare for compact") and the Wiring Mutation Invariant (Pillar 2).
The Operational Dimensions: Why, When, Where, and How
| Dimension | Specification Contract | Operational Details |
|---|---|---|
| WHY | Lossless Memory Persistence & Boundary Guard | Guarantees zero context loss across context window compactions. Externalizes fine-grained findings into the immutable flight recorder while keeping active working memory trimmed to $\le 300$ tokens so post-compact Turn 1 hydration is instant, focused, and drift-free. |
| WHEN | 1. Human Trigger: "prepare for compact"2. Context Saturation (~70–80%) 3. Mid-Shift Milestone Completion |
Triggered mid-shift whenever the developer issues the command "prepare for compact" before running /compact, or whenever token usage approaches window capacity during multi-hour pair programming. |
| WHERE | Cross-Pillar Synchronization: • wiring.yaml (Pillar 2)• sessions/*.md (+1 Flight Recorder)• state.md (Pillar 4)• decisions.md (Pillar 6)• app_map.md (Pillar 5)• roadmap.md (Pillar 3) |
Checkpoints are written to physical disk files before memory is cleared: 1. wiring.yaml: Audited and updated in-stride for newly introduced subsystems.2. sessions/YYYY-MM-DD_<topic>.md: Discrete immutable flight recorder log.3. state.md: Aggressively pruned strictly to $\le 300$ tokens.4. decisions.md: Rejections and dead ends logged.5. app_map.md: Synced with new/modified file paths.6. roadmap.md: [MEASURED] telemetry logged if milestones were met. |
| HOW | 5-Step Automated Execution Cycle | The agent mechanically executes a standardized 5-step checklist and emits an explicit readiness signal before compaction proceeds. |
How It Works: The 5-Step Checkpoint Execution
[Developer: "prepare for compact" or Token Saturation Nears]
│
▼
1. Topology & Subsystem Audit ──► Runs `sdcs verify --topology` to audit wiring.yaml
│
▼
2. Flight Recorder Snapshot ──► Writes immutable log to `sessions/YYYY-MM-DD_<topic>.md`
│
▼
3. Blackboard Pruning ──► Prunes `state.md` to ≤ 300 tokens (Objective + Gate + Next Action)
│
▼
4. Episodic Memory Sweeps ──► Records failed approaches to `decisions.md` & updates `app_map.md`
│
▼
5. Compact Readiness Signal ──► Emits confirmation: "Ready for compaction." (Proceed to /compact)
In-Stride Updates: The Wiring Mutation Invariant (Pillar 2)
During extended engineering sessions, agents often add new packages or refactor module hierarchies. SDCS defines precise rules for when and how agents interact with wiring.yaml:
- In-Stride Updates (Additive): When the agent creates new subsystems, packages, or modules, it MUST update
wiring.yamlin-stride (in the same step/commit as code creation). This ensures that new components have declared boundary contracts before Gate T AST verification runs. - Prohibited Relaxation (Bypasses & Cycles): Modifying
wiring.yamlto relax existing architectural boundaries, add circular dependencies, or bypass Gate T rejections without explicit human authorization (SDCS_ALLOW_INVARIANT_MUTATION=1) is strictly forbidden. If an import fails Gate T, the agent must decouple via dependency inversion or serialize the failure as an Inverted ADR (## REJ-XXX) intodecisions.md.
Automated Integrity Enforcement
SDCS provides deterministic Python tooling to bootstrap repositories and enforce verification gates:
sdcs init(python sdcs_init.py):- Scaffolds the complete 7-pillar framework into any existing repository.
- Automatically indexes existing files and directory structure into
app_map.md. - Generates compliant
AGENTS.mdbehavioral guidance,sessions/template.md, andprompts/grillme.md.
sdcs audit(audit_evals_corpus.py):- Validates that all benchmark fixtures listed in
evals.mdphysically exist on disk. - Computes normalized SHA-256 digests (anti-evasion whitespace/comment invariant).
- Diversity Enforcement: Halts execution if duplicate files masquerade as independent test cases.
- Atomic Recalibration:
--recalibrate <ID>|allcomputes new digests and updatesevals.mdrows directly.
- Validates that all benchmark fixtures listed in
sdcs map(src/sdcs/map.py):- Audits tracked codebase files against
app_map.mdcartography (--check). - Synchronizes
app_map.mdin-stride with disk additions and deletions (--sync), preserving developer annotations.
- Audits tracked codebase files against
sdcs verify(src/sdcs/verifier/):- Gate T (Topology): Statically audits AST imports against
wiring.yamlboundaries without runtime execution (--topology,--append-rejections). - Gate A (Working Memory): Lints
state.mdtoken budget ($\le 350$ tokens) and verifies canonical 3-section schema (--state,--max-tokens).
- Gate T (Topology): Statically audits AST imports against
sdcs session(src/sdcs/session.py):- Indexes historical shift handoffs into single-line metadata (
sessions/manifest.jsonl). - Queries session history without violating the Flight Recorder Invariant (never loading raw session prose on boot).
- Indexes historical shift handoffs into single-line metadata (
sdcs graph(src/sdcs/graph.py):- Renders
wiring.yamlsubsystem contracts into visual Mermaid diagrams or ASCII terminal DAGs.
- Renders
sdcs grill(python sdcs_init.py --grill):- Emits the
/grillmeadversarial spec elicitation prompt to interview human stakeholders and harden requirements into quantifiable[INTENT]contracts before code is generated.
- Emits the
Quickstart
Installation
Install sdcs directly from PyPI via pip:
pip install sdcs
(Alternatively, you can install directly from GitHub, clone for local development, or run the zero-dependency standalone script):
# Direct from GitHub
pip install git+https://github.com/adamm285-dev/Spec-Driven-Cognitive-Scaffolding-SDCS.git
# Or clone and install locally for development
git clone https://github.com/adamm285-dev/Spec-Driven-Cognitive-Scaffolding-SDCS.git
cd Spec-Driven-Cognitive-Scaffolding-SDCS
pip install -e .
# Or run the zero-dependency standalone script directly
python sdcs_init.py --help
1. Initialize SDCS in Any Repository
# Scaffold the 7 pillars + sessions/ + AGENTS.md in repo root
sdcs init
# Or scaffold into a dedicated .agent/ directory
sdcs init --use-agent-dir
CLI Options
--target-dir <path>: Target repository root path (default:.).--use-agent-dir: Store the 7 pillars andsessions/inside.agent/instead of the root.--hierarchical: Generate hierarchical multi-tiered cartography maps for large monorepos.--skip-agents-md: Skip generating theAGENTS.mdbehavioral prompting file.--force: Overwrite existing files.
2. Audit Ground Truth & Recalibrate Fixtures
# Audit evals.md test fixtures and SHA-256 hashes
sdcs audit
# Automatically replace 'pending' entries with computed hashes
sdcs audit --update-pending
# Recalibrate a specific fixture with newly computed SHA-256 digest
sdcs audit --recalibrate TC-001
# Recalibrate all registered fixtures simultaneously
sdcs audit --recalibrate all
- Asset Reachability: Verifies referenced fixture paths exist on disk.
- Cryptographic Accuracy: Asserts recorded SHA-256 digests match file contents.
- Corpus Diversity & Anti-Evasion: Detects both byte-identical files and near-duplicates (fixtures differing only by trivial whitespace, empty lines, or dummy formatting padding).
- One-Step Recalibration: Eliminates the manual edit-to-
pendingdance when updating test fixtures.
3. Verify Codebase Invariants (Topology & Working Memory)
# Statically audit codebase imports against wiring.yaml subsystem boundaries (Gate T)
sdcs verify --topology
# Automatically format boundary violations into inverted ADRs (## REJ-XXX)
# and append them directly to decisions.md
sdcs verify --topology --append-rejections
# Audit working memory state.md token budget (Gate A, default <= 350 tokens)
sdcs verify --state
# Enforce custom token ceiling
sdcs verify --state --max-tokens 300
# Run all verification checks (topology, working memory, and evals)
sdcs verify --all
- Zero Execution Risk: Audits Abstract Syntax Trees (AST) using Python's standard
astmodule without importing or executing runtime code. - Negative Memory Serialization: Programmatically binds architectural failures to Pillar 6 (
decisions.md) using the strict Claim $\rightarrow$ Measurement $\rightarrow$ Reopen Condition schema. - Working Memory Discipline: Prevents context exhaustion by halting when
state.mdexceeds 350 tokens prior to compaction.
4. Cartography Drift Detection & Synchronization
# Check if new or deleted files caused app_map.md to drift (exit code 1 if drift found)
sdcs map --check
# Synchronize app_map.md with disk, preserving existing annotations
sdcs map --sync
5. Structured Flight Recorder Querying
# Index historical sessions into sessions/manifest.jsonl
sdcs session index
# List recent sessions in an aligned terminal table
sdcs session list
# Forensically query sessions by keyword or milestone
sdcs session list --query "GPU"
# Output structured records as JSON
sdcs session list --json
6. Declarative Topology Graph Visualizer
# Render ASCII directed acyclic graph in terminal
sdcs graph --format ascii
# Export Mermaid diagram for documentation or GitHub markdown
sdcs graph --format mermaid --output docs/topology.mmd
7. Adversarial Spec Elicitation (/grillme)
Deterministic runtime execution requires unambiguous specifications. SDCS includes the /grillme Adversarial Spec Elicitation Protocol as an authoring tool to eliminate fuzzy requirements:
# Print the elicitation prompt to copy or pipe into an LLM session
sdcs grill
# Target a specific milestone
sdcs grill --milestone M-002
# Or invoke directly via the bootstrap script
python sdcs_init.py --grill
- Zero Tolerance for Vague Adjectives: Rejects terms like "fast", "clean", or "scalable".
- Extracts Hard Ceilings & Floors: Demands quantitative latency, throughput, memory, and coverage targets.
- Auto-Populates
roadmap.md: Generates structured[INTENT]and[MEASURED]acceptance criteria. - Scaffolded File: Generated at
prompts/grillme.md(or.agent/prompts/grillme.md).
Operational Scale Profiles
SDCS is built for autonomous, multi-turn shifts where context drift causes expensive regressions—not for single-line autocomplete. To prevent ceremony overhead on small tasks, use the appropriate profile:
| Profile | Hydration Set | Token Budget | Ideal For |
|---|---|---|---|
| Lite | spine.md + state.md |
~400 tokens | Interactive pair-programming, CSS/typo fixes, quick single-file refactors. |
| Standard | spine.md + roadmap.md + app_map.md + state.md |
~1,500 tokens | Subsystem feature work, localized refactors, unit test coverage expansion. |
| Full Shift | All 7 Pillars + sessions/template.md on close-out |
~2,500–3,500 tokens | Autonomous multi-turn agent runs, overnight refactors, cross-subsystem migrations. |
Pragmatic Enforcement & The Permission Boundary
Defense-in-Depth: Stopping the "Soft Invariant" Hole
When an autonomous agent encounters a failing test gate on Turn 12, a known failure mode is rationalization: editing spine.md or altering test runner flags to force "task completion." SDCS secures invariants across distinct architectural layers:
- Behavioral Layer (
AGENTS.md): Non-negotiable system rules prohibiting invariant tampering and requiring structured hydration. - Topological Invariant Gate (Gate T): AST-level static import audit ensuring code respects
wiring.yamlsubsystem boundaries, serializing violations intodecisions.md. - Constitutional Invariant Gate (Gate C): Pre-commit hook automatically rejects commits modifying
spine.mdorwiring.yamlunless explicitly overridden viaSDCS_ALLOW_CONSTITUTIONAL_MUTATION=1. - Working Memory Sync Gate (Gate S): CI/pre-commit checks requiring
state.mdsynchronization whenever PRs or commits introduce $\ge 40$ modified lines. - OS / Container Sandbox: In automated agent environments,
spine.mdandwiring.yamlcan be locked viachmod 444or mounted as read-only volumes (:ro).
Git Hook Modes
| Strategy | Ideal Scenario | Mechanics | Velocity Impact |
|---|---|---|---|
Behavioral Prompting (AGENTS.md) (Recommended) |
Solo developers, rapid prototyping, interactive pair programming. | Embeds hydration order, wiring invariants, and mid-shift checkpoint ("prepare for compact") protocols into agent system rules. | Zero friction. Keeps you in flow state without blocking terminal commands. |
Advisory Git Hook (sdcs.mode advisory) |
Teams that want gentle reminders when refactors get large. | Emits terminal warnings on commits ≥ 40 lines without aborting. | Zero blockage. Visual feedback without interrupting commit flow. |
Strict Git Hook (sdcs.mode strict) |
Unattended autonomous loops, background agents, and CI/CD pipelines. | Rejects commits if state.md is missing, constitutional invariants are mutated (Gate C), or AST topology boundaries are breached (Gate T). |
High rigor. Guarantees memory synchronization and invariant integrity. |
Activating Git Hooks
# Configure git to use the repository hooks directory
git config core.hooksPath .githooks
# Select mode: 'advisory' (warning only) or 'strict' (blocking gate)
git config sdcs.mode advisory
Author & Citation
If you use SDCS or reference the SPEC-001 architecture in your research, agent frameworks, or production systems, please cite the project:
@software{murphy2026sdcs,
author = {Murphy, Adam},
title = {Spec-Driven Cognitive Scaffolding (SPEC-001): A Deterministic Architecture for Autonomous Coding Agents},
year = {2026},
version = {v1.4.0},
publisher = {GitHub},
howpublished = {\url{https://github.com/adamm285-dev/Spec-Driven-Cognitive-Scaffolding-SDCS}}
}
- Author: Adam Murphy
- License: MIT
- Contributing: CONTRIBUTING.md
- Security Policy: SECURITY.md
Metadata
Release files for sdcs 1.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| sdcs-1.4.0.tar.gz | 60.3 kB | Without provenance | Details for sdcs-1.4.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| sdcs-1.4.0-py3-none-any.whl | Python 3 | none | any | Details for sdcs-1.4.0-py3-none-any.whl |
Total release size: 104.7 kB
Release files / sdcs-1.4.0.tar.gz
| Download URL | sdcs-1.4.0.tar.gz |
|---|---|
| Size | 60.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8238f0723c9e8d736366bca038e9d572cd93faee33374fe76b07398a0f99c700
|
|
BLAKE2b-256 checksum How to use checksums |
d580d649cd802eb4cedca993654a4345c679727e05c7e75d7bad44ea6fcfe2b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.6
|
Release files / sdcs-1.4.0-py3-none-any.whl
| Download URL | sdcs-1.4.0-py3-none-any.whl |
|---|---|
| Size | 44.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3c3d0f36083fca848a8a8a9c765ceb7277fb72a775deb86d0b321c44e3100ff0
|
|
BLAKE2b-256 checksum How to use checksums |
c5f3456bcc0c9622dab5435a195116065360b4799bd29bb828616f9edc736e1b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.6
|
Security for sdcs 1.4.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.