Add a working vision document

Open Beginner friendly
#3,062 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
75/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Domain
documentation

Research direction

Create the root-level VISION.md and review the existing documentation navigation to find where it should be linked. The work is done when the document presents a changeable working vision without roadmap, schedule, guarantee, obligation, or commitment language, and is discoverable from the documentation site.

Written by the indexing model from the issue text.

Description

bug-assess invalid stale

Summary

Add a root-level VISION.md that describes the project's working vision for Spec Kit and agentic software development.

Notes

The document should be clear that it is a working vision maintained by the Spec Kit maintainers. It should not be framed as a roadmap, release schedule, guarantee, obligation, or commitment. It should also state that the content can change, be replaced, or be removed at any time.

Suggested docs integration

Reflect the root-level vision document in the docs navigation so it is discoverable from the documentation site.

Dominant language
Python
Stars
138k
Forks
12.4k
Avg merge
3d 6h
Merged PRs (30d)
136

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from github/spec-kit

All issues in github/spec-kit

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.