Skip to content

Commit b1fac4f

Browse files
committed
Update readme
1 parent afc4f3a commit b1fac4f

File tree

2 files changed

+14
-15
lines changed

2 files changed

+14
-15
lines changed

README.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -227,7 +227,15 @@ SpecOps was developed to address the unique challenges of government legacy syst
227227

228228
The methodology combines proven practices from incremental modernization (Strangler Fig pattern), infrastructure as code (GitOps), and specification-driven development, adapted for the era of AI-assisted software development.
229229

230-
The goal: Make legacy modernization more effective, sustainable, and knowledge-preserving for everyone.
230+
### Built on Specification-Driven Development
231+
232+
SpecOps builds on the foundation of [specification-driven development](https://github.com/github/spec-kit), an approach where specifications are created before implementation and serve as the authoritative source of truth. As GitHub's [spec-kit](https://github.com/github/spec-kit) describes it:
233+
234+
> "Specification-driven development is a software development approach where you write a detailed specification of your software's behavior before writing any implementation code. The specification serves as both documentation and a contract that your implementation must fulfill."
235+
236+
GitHub's spec-kit provides essential tooling for this approach, including specification templates, validation tools, and integration with AI coding agents. SpecOps extends these principles specifically for legacy system modernization, adding workflows for extracting specifications from existing systems, domain expert verification processes, and patterns for incremental replacement.
237+
238+
**The goal**: Make legacy modernization more effective, sustainable, and knowledge-preserving for everyone.
231239

232240
---
233241

docs/index.html

Lines changed: 5 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -437,7 +437,7 @@ <h4>The SpecOps Solution</h4>
437437
<h4>Specification-Driven Development</h4>
438438
<p>
439439
The specification precedes and governs all implementation. Once the legacy system's behavior is
440-
captured in a verified specification, AI coding agents use that specification to generate modern
440+
captured in a verified specification, <a href="https://github.com/github/spec-kit">AI coding agents</a> use that specification to generate modern
441441
implementations—transforming documented knowledge into working code.
442442
</p>
443443
</div>
@@ -614,18 +614,6 @@ <h3>Instruction Sets</h3>
614614
<span class="arrow"></span>
615615
</p>
616616
</a>
617-
618-
<a href="https://github.com/mheadd/spec-ops/blob/main/public/REFERENCE-IMPLEMENTATION.md" class="doc-card">
619-
<div class="doc-card-header">
620-
<span class="doc-icon">🚧</span>
621-
<h3>Reference Implementation</h3>
622-
</div>
623-
<p>
624-
<em>(In Development)</em> A complete, working example of SpecOps applied to a real legacy system.
625-
Will provide reusable artifacts, templates, and lessons learned.
626-
<span class="arrow"></span>
627-
</p>
628-
</a>
629617
</div>
630618
</div>
631619
</section>
@@ -637,7 +625,10 @@ <h2 class="section-title">Get Started</h2>
637625
Join the community building a better approach to legacy modernization
638626
</p>
639627
<div class="cta-buttons">
640-
<a href="https://github.com/mheadd/spec-ops" class="btn btn-primary">
628+
<a href="mailto:hello@adhoc.team" class="btn btn-primary">
629+
Contact Us
630+
</a>
631+
<a href="https://github.com/mheadd/spec-ops" class="btn btn-secondary">
641632
View on GitHub
642633
</a>
643634
<a href="https://github.com/mheadd/spec-ops/discussions" class="btn btn-secondary">

0 commit comments

Comments
 (0)